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Preface 


This User Guide and Quick Reference is one of two instruction manuals‘supplied 
with BASIC 2 Plus. The other is the Language Reference Manual. 

The User Guide section of this manual explains how to use the BASIC 2 Plus 
program. It describes how to enter programs into your computer, how to save them, 
and so on. There is also a complete description of BASIC 2 Plus’s powerful mouse- 
driven editor, and a large section on the debugging tools available. 

The User Guide docs not give a full description of how the commands work. For 
that, you must refer to the Language Reference Manual, the second book supplied 
with BASIC 2 Plus. This descibes the language in great detail. However, the User 
Guide does give a 'Quick Reference' summary of the syntax of all the commands 
available in BASIC 2 Plus, each with brief explanation of what they do. 

If you have programmed in BASIC 2, the predecessor of BASIC 2 Plus, you will 
notice some new facilities. Such structures as the SELECT CASE statement and 
the block IF statement make structured programming much easier. Routines are 
now implemented, and it is now possible for your program to be split into different 
program units - a main program and several modules. Read Chapters 5,6, and 7 in 
theLanguage Reference Manual for details. 

When programming, you will sec that you now have a powerful mouse-driven ‘cut- 
and-paste’ editor to work with. There are lots of facilities for debugging your 
programs, too. But perhaps the first thing you’ll notice, especially if you are running 
very large programs, is the speed of BASIC 2 Plus. One of the standard test 
programs runs over six times faster in BASIC 2 Plus than in BASIC 2. 

IMPORTANT: Before running any BASIC 2 program under BASIC 2 Plus, you are advisedfirst to 
scan through the program in the Edit window to see if any of the variables are being 
shown in capital letter. If any are, then you will need to change the name of this 
variable because this name is now used as a BASIC 2 Keyword. 

You are also advised to use BASIC 2 Plus's Check-out option to 'Pre-scan' 
your program before running it (as described in the section on 'Programming' in 
Chapter 1 of the User Guide). 
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BASIC's Basics 


BASIC 2 Plus works with GEM, the window manager on your computer. This guide 
assumes that you have GEM installed on your computer and that you have some experience 
of using it; specifically, it assumes that you know how to select, scroll, resize, and close 
windows, how to pull down menus and select options from them, and that you understand 
how to select files from a disc using the Item Selector Dialog. If you aren't familiar with 
these tasks, read about GEM in the manual that came with your computer. 

Assuming, then, that you are reasonably familiar with GEM and the features it offers, make a 
back-up copy of your BASIC 2 Plus disc, load GEM, and then double click on the file 
B2PLUS.APP to load BASIC. You should see the BASIC 2 Plus screen; it looks like this: 


File Diev Program Debug Edit Search Windows B2PLUS 
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If you see BASIC 2 Plus start to open but you are almost immediately returned to the GEM 
desktop, you probably haven't got enough memory available. Try removing fonts from your 
system, or freeing memory in other ways. (You can discover how much free memory there is 
available by typing PRINT FRE in the Dialogue window.) 

There are various things to note about the screen. As with most GEM applications, there is a 
menu bar at the top of the screen providing assorted commands which are always available 
for you to use. 

Notice the windows on the screen. Generally when BASIC 2 Plus starts up, there are four of 
these, though one of them (Results-2) is covered up by the Edit window and the Dialogue 
window. (If you are short of memory, Results-2 may not be displayed at all. This isn't a 
serious problem, though it may restrict you a little if you need to make full use of BASIC 2 
Plus's output facilities.) 

The four windows are: 

The Dialogue window. This is for typing commands directly into BASIC 2 Plus. 

The Edit window. When you load BASIC 2 Plus this is headed Empty Program. This is 
the window where you type your programs in and edit them. 

Results-! and Results-2. These are for displaying output. While you are becoming 
familiar with BASIC 2 Plus you will probably just use Results-1, though as explained in the 
Reference Guide, in the right circumstances Results-2 is faster and holds more information. 

These windows arc standard GEM windows and they can be moved and resized in the usual 
way. If you close them, you can open them again by selecting the appropriate option from the 
Windows menu. If you choose the menu option to show a certain window when that window 
is already visible and active, it has the same effect as clicking on the 'grow box' in the top 
right-hand comer of the window. 

The Dialogue window has an information line just below its name bar. This displays a 
message to show what BASIC 2 Plus is curenlly doing. When you load the program, the 
status line reads D1 rect Command; Clear. This shows that BASIC 2 Plus is ready to 
receive commands directly into its Dialogue window, and that none of the Dialogue 
window's variables is currently assigned. 
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FRE 

Use FRE is a function which returns the amount of unused memory. 
Syntax FRE 



CLEAR 

Use 

CLEAR discards all variables. 

Syntax 

CLEAR ! 

Note 

CLEAR may only be in Direct Mode. 


Typing commands directly 

Commands which you type directly into the Dialogue window are executed as soon as you 
press GED. Any output from these commands will appear in the Results-1 window, by 
default. Try this, if you like, by experimenting with simple commands like 

print pi 
birdcount = 24 

print "There are": birdcount : "blackbirds in a" : pi 

In this way you can use the Dialogue window like a calculator. Notice, incidentally, that as 
soon as any variables are assigned, the variable space is no longer 'clear' and so the 
information line changes from Di rect Command: Clear to Di rect Command. 

Unlike some BASICs, you cannot write a program by typing numbered statements in this 
way: programs have to be typed and edited in the Edit window. 

Once a program has been written, though, you can use the Dialogue window to examine the 
value of the program's variables after it has Finished running, or while it is temporarily 
stopped in the middle of a run. This is an important technique for debugging, and it will be 
explained in Chapter 4 of this part of the manual. 


Getting Started 








Programming 


To write a simple program, click on the Edit window (the one with Empty Prog ram in the 
title bar) to make it active, and then enter the text of your code. If you make mistakes, you can 
erase them with the r»osn key or you can use BASIC 2 Plus's sophisticated built-in editor 
described in Chapter 2. 

Notice how each line appears in the Edit window exactly as you type it; upper and lower case 
letters appear as they are input from the keyboard. But as soon as you press dll (or move the 
cursor to a new line by any other means) BASIC 2 Plus's keywords are transformed into 
capital letters, while your invented names and identifiers are transformed into lower case. 
Notice also how carriage return is displayed as ▼. 

When your program is ready, select Run from the Program menu. The first thing BASIC 2 
Plus does is pre-scan the program, checking for syntax and other simple errors. This means 
that elementary errors in your code will be discovered very quickly, even if they appear in a 
rarely executed part of the program. 

If there are any pre-scan errors, a message will appear in the Dialogue window, and in the 
Edit window the cursor will move to the first offending line. You can then correct the error, 
and select Run again. 

When you have removed all the pre-scan errors, selecting Run will start to run the program. 
This time the program will stop at run-time errors which the pre-scan could not discover: 



RUN 

Use 

RUN starts executing the current program. 

Syntax 

RUN 

Description 

RUN may be executed in a program, terminating the program and starting it all 
over again. 


EDIT 

Use 

EDIT takes you into the edit window. 

Syntax 

EDIT 

Note 

EDIT may only be in Direct Mode. 
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Note cursor 


File View Proyan Debug Edit Search Windows 


Dial 


Running Full s 


J2\TESTING\BEAU 
Load Proyan 
52\TESTING\DISC 
Run 

159.37 159.38 
Progran END 
Run 

Error in : Pr 
Division by z 
Continue 


Lqpu 

iL 


I 


B2PLUS 


OPTION ARITHNETIC DECIMAL^ 

discount ” 45* 

▼ 

sun_of_rounded = 0* 
rounded sun ■ 0* 


DISCOUNT.BAS Proyan 





READ count* 
FOR i - 1 T 
READ Tull 
discounte 
rounded_s 
sun oF ro 
NEXT* 


roundedjsun = rowded»jn_/.tl* 

? rotnded_SLBj^surTJTrajnded T 

▼ _ 

END* 

DATA 5* 

DATA 90.92, 87.14, 15.84, 21.25, 74.61’- 


nt) / 100)* 
mice* 

nted_price, 2)’ 


I 


errors such as division by zero, or references to a non-existent file, for example. When a run¬ 
time error is discovered, the program halts and an Alert is displayed with a brief indication of 
what the problem is. As with syntax errors, the cursor will position itself near the offending 
statement in the Edit window. For example, see the picture on the following page. 

When a program stops because of a run-time error, you can be sure that execution has at least 
started, and so in tracking down the bug it may be helpful if to inspect the program's 
variables. (You can do this by entering PRINT variable-name into the Dialogue window.) 
Changing the program will mean losing the contents of these variables, and you may not wish 
to do this; so before you can edit your program after a run-time bug, a dialogue appears 
warning you that you are about to destroy the value held in your program's variables. 

If you need to pre-scan a program without running it, select the option Check out on the 
Program menu. 

If the program runs successfully, it will finish by displaying an Alert with the words 
Program END. Clear the dialogue by clicking on OK. 
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Leaving BASIC 2 Plus 


To leave BASIC 2 Plus, select Qui t from the File menu. If any of your work has not been 
saved to disc, you will be given the opportunity to save it. 



QUIT & SYSTEM 

Use 

These statements take you out of BASIC 2 Plus. 

Syntax 

QUIT 

or 

SYSTEM 

Description 

QUIT or SYSTEM may be executed in a program, terminating the program and 
then leaving BASIC 2 Plus. 


Accelerators 


In common with other GEM-based programs, many of the menu options can be executed 
from the keyboard instead of using the mouse. If a menu option is followed by the name of a 
key, that key has the same effect as the menu option. Run, for example, is followed by 19 in 
the Edit menu; so pressing the function key GE) has the same effect as selecting Run from the 
menu. A caret ( A ) before a key indicates that the key should be pressed with held down. 

A diamond ♦ shows that (an] should be held down. 

Accelerators for commands in the Windows menu are not available when a program is 
running, and for this reason they are not displayed in the menu. They are: 


CD 

Show Results-1 

rm 

Show Results-2 

CD 

Show Edit or Results-3 

C5D 

Show Dialogue or Results-4 

resn + rm 

Hide Results-1 

nsn + r?n 

Hide Results-2 

rcun + rm 

Hide Edit or Results-3 

rein + CHD 

Hide Dialogue or Rcsults-4 

IaTI + QT] 

Show Edit 

1 Ah I + I ft 1 

Show Dialogue 


Show Edi t also displays the Dialogue window. 

Show Results-3 and Show Results-4 arc not available unless these windows have been 
opened on a stream. Sec Chapter 9 of the Reference Manual to sec how to do this. 
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i Chapter 2 ■ 

The Editor 


BASIC 2 Plus includes a powerful editor which takes full advantage of the facilities that 
GEM affords. Many changes have been made since the previous version and these have 
brought it into line with other editors which run in a similar environment If you have used 
the BASIC 2 editor, you will find this new version quicker and easier to use. If you have 
never used a ‘cut & paste’ editor before, you will find it to be a straightforward and natural 
method of entering and amending your text 

All editing is done in one window - the Edit window. This can be used to give a number of 
different views of the program (selected from the View menu, as we shall see later) but all 
changes arc made in the text view that BASIC 2 Plus starts in. 

The Edit window is initially is called Empty Program, but this title changes to reflect any 
files you’ve loaded or saved. It must be the active window before you can use it, so if the 
window’s title is dimmed, click the mouse anywhere in the window to activate it (You can 
also activate the window by selecting Show Edit in the Windows menu (or by pressing Q5] ); 
in fact, if the window has been closed, you have to activate it in this way.) 

The text displayed in the window is simply the text of the program unit you are editing. If the 
window is not wide enough to hold any of the lines, they will automatically wrap round to the 
next line of the window and a small mark will appear at the beginning and the end of the 
broken line. This does not imply a new line of the program; program lines are always 
separated with typed carriage return characters, which are displayed on the screen as ▼. 

Inserting text is quite straightforward. Click at the point in the program where you wish to 
insert the extra text; the cursor will move to that place. Now simply type the additional text, 
and it will be added at the position maiked by the cursor. 

The Carriage return symbols behave quite logically when you insert text If you want to 
append more characters to the end of a line, you must take care to put the insertion point 
before the carriage return symbol, or the characters will be inserted after the carriage return, 
that is, at the start of the next line. 

The two delete keys can be used to delete characters in two different directions as you’d 
expect: the r-*-'o5l key removes the character just before the cursor (that is, the character 
' you’ve just typed), whereas the [cw] key removes the character just after it. 
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Selecting text 


One important facility which the editor provides is a means to handle whole blocks of text 
quickly and conveniently. This is one area where the editor has been changed from BASIC 2. 
Instead of selecting the beginning and end of the block separately, they are selected by 
‘dragging’ the pointer across text to select a continuous block, as described in the next few 
paragraphs. 




Selecting a block 


Begin by positioning the pointer at one end of the block you wish to select Click the left- 
hand mouse button, but do not release it Now ‘drag’ the mouse across the text (without 
releasing the button) and as you do so you will see that the block of text between the pointer 
and the place you originally clicked will become highlighted. (The exact colour change will 
depend on the system you are using.) Move the pointer to the other end of the block of text, 
and release the button. The whole block will stay highlighted, and the block is now selected 
and ready for you to operate on. 



DISCOUNT.BAS Program 


OPTION ARITHMETIC DECIMAL* 
discount = 45* 


T 


sun_oF_rounded = 0* 
rounded sun = 8* 


READ count* 




sun of rounded = sun of rounded ♦ R(M1D( discounted_price, 2)* 
NEXT* 


T 


routdedjsun = ROUND(rounded.sun, 2)* 
? rounded.sun; sun_of_rounded* 


END* 

DATA 5* 

DATA 90.92, 87.14, 15.84, 21.25, 74.61* 


T 


I 


8 
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If you position the pointer inaccurately and find that the selected block is not what you want, 
clear the selection by clicking and releasing the mouse button anywhere on the window. The 
highlighting will clear as you do this. (On colour monitors there may be some flickering of 
colours as you do this.) 

Selecting a Large Block 

If you need to select more text than will fit into the window, select the start of the block as 
described above. Then, with the mouse button still held down, move the pointer beyond the 
top or bottom edge of the window. The text will scroll, highlighting as it goes. When enough 
text is in view, release the mouse button at the other end of your selected block. (When the 
text is scrolling, it will move rather faster if the cursor is well outside the window. If you 
want it to scroll slowly only move the cursor slightly beyond the edge.) 

If the block you want to select is very large, there is an alternative technique. Using the 
method already described, select a small piece of text at one end of the block. Then move to 
the other end using the scroll bars, and press the GEI key as you click the mouse button in the 
appropriate place. All the text from the small block to the Shift-click will be selected, and 
will be highlighted on the screen. 

Deleting a Block 

To delete a block of text, select it and then press either of the delete keys. When a block of 
text is selected, r^csn and [SO both have the same effect Or, to replace the block with 
different text select the block and then type. Typing when there is a block selected replaces 
the block with whatever is typed. 


Cut and Paste 

Instead of deleting a block of text, you may want to transfer it to another part of the program. 
The way to do this is by ‘cutting and pasting’ using two of the options available on the Edit 
menu. 

Begin by selecting the block of text, as explained above. Do not delete it, but select Cut 
from the Edit menu. You will see the text disappear from your program. It has not been 
annihilated, though; it has been moved to a special area called the Clipboard. (Later, we shall 
see how to inspect the contents of the Clipboard and edit them directly.) 

Position the cursor at the point where you want the text moved to. Select Paste (again from 
the Edit menu) and the contents of the clipboard will be inserted at the point selected. 
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Pasting text does not delete it from the clipboard, so you can paste it again in many different 
places if you like. 

If you want to copy a block of text without deleting it from its original position, select it in the 
usual way and then choose Copy from the Edit menu. This replaces the Clipboard’s 
contents with a copy of the selected text. The new contents of the Clipboard can be pasted 
wherever you like in the program. 

In fact, the Clipboard is maintained when one Tile is saved and another loaded, so you can use 
this technique to transfer lines of code from one program to another. 

If you explicitly want to empty the Clipboard of text, the Edit menu’s Clear option docs 
this. This is different from the way Clear works on some other ‘Cut and Paste’ systems. 


Search and Replace 

Irr common with many editors, there is a facility for finding a text string and, if necessary, 
substituting another. All the options in connection with this arc available through the Search 
menu. 

To find a specified suing, choose Search from the menu. BASIC 2 Plus displays a dialogue 
box prompting you to insert the suing to search for: 




1 Search 1 

Search for: 1_ 



il 



1 Whole words 

Backwards 

| Cancel | 

_l 


Type the search suing into the box, select the direction you wish to search in, and click on the 
Search box. BASIC 2 Plus will search from the current position of the cursor until it finds the 
string. 

Pressing the GD key has the same effect as clicking on the SEARCH button. Because of this 
there is no way to search for a suing containing a carriage return. 
























H 
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If you choose the Whol e Words option instead of Everywhere in the dialogue box, only 
whole words will be found. This means that the specified string will only be found if it 
appears in the program delimited by characters other than letters (including Greek and 
accented letters), numbers, and the underline character. Note that this does not restrict the 
range of characters which may be included in a search string; it simply defines the characters 
which delimit a word. 

For example, if a line of the program read 

LET frederick$.details.titles - “The Great" 

If the Whole Words option was selected. Search would not find this line if the search 
string was f red, but it would find it if the search string was f rederi ck or f rederi ckS. 
This is because in the first case f rederi ck is delimited by a space character before and a S 
behind, and in the second case f rederi ck$ is delimited by a space in front and a full stop 
behind. Since the space character, the dollar, and the full stop are all characters which can be 
used to delimit whole words, both f rederi ck and f rederi ck$ can be found by Search 
withtheWhole Words option. 

If the editor finds an occurrence of the string but not the specific occurrence you need, you 
can repeat the search (starting from the end of the string found by the first search) by 
selecting Sea rch again from the Edit menu. 

Note that, since the repeated search starts from the end of the suing found by the first search, 
the two strings cannot overlap. For example, searching for i ssi will stop at the word 
Mi ssi ssi ppi. If you then choose Search agai n, the editor will not find the second 
occurrence of i ssi in Mi ssi ssi ppi .because the search starts after the second letter i in the 
word. 


Replacing 

Replacing is similar to search except that when it finds the string the editor will substitute 
another. When you choose Repl ace..., you will be prompted for the two strings. 

Replace... includes the option of Manual or Automatic replacement Automatic 
replaces all the occurrences of the first string with the second without further ado. Manual 
stops at each occurrence and asks you whether you wish to replace or not. 

Replace..., like Search again, continues its search from the end of the previous 
suing. 
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Merge 


The Merge option on the Edit menu is used to insert text from one file into another. When 
you select Merge, a dialogue box will prompt you for a file to insert This must be a text file; 
it can have been prepared using the BASIC 2 Plus editor itself or another text editor. 



Outlining 






Large programs in BASIC 2 Plus may well include a number of routines - subprograms and 
functions. (How these fit into the structure of a program is explained in Chapter 6 of the 
Language Reference) When there are a great many routines in a program, it can be difficult 
to keep track of them all, so to help with this, the editor provides the Outline view of a 
program or module. 

If, when you are editing a program or module, you select the Outl i ne option in the View 
menu, the first line of every routine in that program or module is displayed in the Edit 
window. The order these lines are displayed in corresponds to the order in which the routines 
are declared in the file. 

Outline view provides a convenient way of skipping around a file when editing it; if you need 
to change a line in one of the routines, there is no need to hunt up and down the file, trying to 
find where the routine is declared. Simply select the Outline view and double-click on the 
routine you wish to edit You will be relumed to editing mode, with the routine of your 
choice displayed in the window. 

You cannot edit directly with the Outline view selected, but you can copy text to the 
Clipboard. This is particularly useful when routines are exported to and from modules; to 
make sure the routine’s name is declared correctly in the IMPORT block, select the Outline 
view and Copy the name to the clipboard. From there, it can be pasted directly to the 
importing module, and you can be sure of not introducing typing errors. 

When the Outline view is displayed, the Li st... option in the File menu changes to Li s t 
Outl ine.... Selecting it will print a copy the Outline view of the program. 

There is an accelerator for selecting the Outline view; instead of selecting Outline in the 
View menu, press CEzD to achieve the same effecL G«] returns you to normal editing. 
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Other Features 


Options 

Selecting Opti ons on the Edit menu gives you access to three facilities offered by the editor 
the means to turn off Insert mode, and the Auto-indent facility; it also allows you to set the tab 
interval. These facilites are described in the next three sections. 

Insert Mode 

Normally, when you type text into the Edi t window, the characters you type are inserted at ^ 

the cursor, and the rest of the line shuffles along to make room for the insertion. This is jj| 

generally what you will want Sometimes, though, it is more convenient for the characters f 

typed in to overwrite the characters already on the screen. BASIC 2 Plus allows you to do T 

this by turning off Insert mode. This is done by choosing Options from the Edit menu, and |f 

then selecting Insert Off. E 

Or, to save using the menus, you can toggle Insert mode (that is, turn it on if it’s off, and off if fcj 

it’s on) by pressing the Dm] key. js 

Auto-Indent 

Some of the new block structures in BASIC 2 Plus (compound IF statements, FOR loops, and 
so on) are much easier to read if the body of the loop is indented by a couple of spaces. To 
make it more convenient to type leading spaces at the start of every line, BASIC 2 Plus 
provides the Auto-indent option. 

When Auto-Indent is turned on, every time a carriage return is inserted into the program it is 
automatically followed by enough blank spaces to ensure that the first character typed on the 
new line is directly under the first character of the previous line. If the previous line had no 
leading spaces, no spaces will be generated at the start of the new line. Any or all of the 
spaces can be deleted if they are not required. 

Tab Interval 

When you press the □□ key, the editor inserts enough spaces to take the cursor to the next tab 
stop. By default, tab stops are every two character widths across the screen, but you can 
adjust this to whatever value you want by changing the value via Options on the Edit menu. 

The editor always inserts spaces, not tab characters; this means that you can remove excess 
space a character at a time if you wish. 
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Renumber 


Renumber... is a facility available under the Edit menu. It is not normally needed with 
BASIC 2 Plus, since BASIC 2 Plus uses line numbers very little. However, should you need 
(or prefer) to write a program with line numbers, Renumber... provides the easiest way to 
do this. 

When you select Ren umbe r..., a dialogue box appears with three options: Remove, As Is, 
and Add. You can specify the line number of the first numbered line and the step size, that is, 
the difference between each line number and the next. 

Choosing Remove, As Is, or Add will rationalise the line numbers in your program Add will 
number all the lines in the program; As I s will number only those lines which already have 
numbers, and Remove will number only those lines which are referenced by GOTO, GOSUB or 
other BASIC 2 Plus commands. In all three cases the numbering will start at the number 
specified by Fi r st line, and will continue in steps specified by Li ne No Step. 

Rationalising line numbers means more than just renumbering the lines; it also means that 
references to lines throughout the program are kept consistent. For example, if the program 
contains the line 

GOTO 255 

it will be changed to make sure control still passes to the correct place. If line 255 has been 
renumbered to 120, then the above line will be altered to 


GOTO 120 















Chapter 3 

File Management 


This chapter describes the way BASIC 2 Plus manages files - how to load and save files to 
disc, and how to list them to the printer. This is done with commands from the File menu. 
The chapter also explains the other commands on that menu, such as Loa d and Run... and 
All new. 

There is then a description of the 'Workspace view' of your program, an overall view of the 
structure which gives access to the main program and its modules. It is the means of 
changing the clipboard directly, and it allows you to edit the Debug command screen , an 
essential tool for debugging whose use will be explained in the next chapter. 

The Current Workspace Component 

Before an explanation of the File menu can be given, though, it is necessary to give a loose 
description of an important concept: the Current Workspace Component (The precise 
description is given later in this chapter.) 

There are twelve Workspace Components in all - 'slots' in your computer's memory into 
which a block of text can be loaded. At any time, one of these Workspace Components is the 
Current Workspace Component, and it is this that many of the File menu’s options work on. 

If you are new to BASIC 2 Plus, you can think of the Current Workspace Component as an 
area of your computer's memory where your program is stored. Later, when you have more 
experience and need to write programs with modules and use the Debug command screen, 
you should read the last section of this chapter to get an accurate grasp of the full picture. 
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The File menu 


File 


Load and Rim... 


Load Progran... 
Save... 

Save as... 
List... 

New 


All new 

Save all 





The File menu appears as shown in the margin. 

Some of the options may be dimmed, of course, to indicate that they are not available. 
Save... for instance, is not available until there is something in memory to save. 

Save... 

Sa ve... is used to save the content of the Current Workspace Component to a disc File. If it 
has not been saved previously and was not loaded from a disc File, you will be prompted for 
the name of the File to save it in with this dialogue: 


ITEM SELECTOR 

Directory: C:\IMD1MID\MST\*.BflS_ 

Selection: UARTRV .BAsI 


j OK 

| Cancel 


H *.BAS 

♦ DUMPS . 

A 

♦ EXAMPLES. 


♦ OLDBASE . 


CONS .BAS 


ERORLIST.BAS 


FILETEST.BAS 

rj. 

FROGS .BAS 


LOAD .BAS 


QS .BAS 

T 


If you have saved previously, or if you did load the Current Workspace Component from a 
file, the edited version will be saved under the same name. In either case you are warned that 
BASIC 2 Plus is about to save the file. This gives you the chance to cancel the operation at 
the last minute, or to save under a different name. 
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Save as... 


To save the content of the Current Workspace Component under a new name, select Save 
as..,. This will always prompt you for the name of the file to save in. 

If the file name you choose already exists, BASIC 2 Plus displays a warning: 


About to Save VflRTRV.BAS Program as 
C:\IHDIWID\MST\UftRTRV.BfiS 


UJZ 

| Save as.7!~| 


WARNING: file already exists. 
"OK" will overwrite it. 


| Cancel ~1 


You are then given the opportunity to save under a different name, or abort the save 
altogether. 


Save all 

Whereas Save... saves the contents of the Current Workspace Component, Save all 
saves the contents of all the Workspace Components which are reserved for programs or 
modules. It does this regardless of the Current Workspace Component (It docs not save the 
Debug command screen or the Clipboard.) 


Load Program... 

Theoption Load Program... changes, depending on the Current Workspace Component 
If the Current Workspace Component is a module, for instance, this option will change to 
Load Module.... Or it can appear as Load Debug... ,or Load Clipboard.... 

However the option appears, when you select it you will be presented with a dialogue from 
which you should choose a file. This file will then be loaded into the Current Workspace 
Component If loading would overwrite unsaved text, you are warned and given the choice 
of saving, of discarding, or of cancelling the whole operation. 
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New 


New clears the Current Workspace Component so that it is available for you to type in fresh 
text As with Load Program... you are warned if New is about to annihilate anything 
which has not been saved to disc. 

All new is similar, except that instead of clearing the Current Workspace Component it 
clears all the Workspace Components which are reserved for programs or modules. It does 
this regardless of the Current Workspace Component 


Load and Run 

Load and run... is similar to Load... , except that the file you load is run 
immediately. The only program units you can load and run are main programs: you cannot 
run a module directly. For this reason Load and run... always loads into the main 
program, irrespective of the Current Workspace Component 


List... 


List... normally sends the contents of the Current Workspace Component to the printer. 
When you select it the following dialogue is displayed: 


[HiD 

About to List VARTRV.BAS Progran 

Reaark: |_ 


Printer: PRH 


II Use forn feeds || 


| Use line feeds | 


Lines per page: 50 
Paper Length: 66 
Paper Width: 132 

| Cancel | 


You can adjust the number of lines per page, the paper length, and the paper width from this 
dialogue. You can also specify a remark to be printed at the head of the listing. 

The options Use Form Feeds and Use Line Feeds control what BASIC 2 Plus sends to 
the printer when a new page is needed. If the former option is selected, a form feed character 
is sent; if the latter option is selected, BASIC 2 Plus sends enough line feed characters to take 
the printer to the top of the next page. 
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However, List... is slightly different from other options in the File menu; it changes 
according to the view you have selected. 

Different views are selected from the View menu. If you select the 'standard' view (the 
second one on the View menu) or the Workspace view. List... works exactly as 
described above. 

But if you have either selected Outline view (described in the previous chapter) or Traceback 
view (described in the next) the List... item changes to Li st Outl ine... or List 
Tr a ceba ck... respectively. When you select these options, BASIC 2 Plus does not list the 
Current Workspace Component; instead, it lists the outline, or the traceback, of your 
program. In fact, what is listed to the printer in these circumstances is the contents of the Edit 
screen. 

Quit 

Quite straightforwardly. Quit quits BASIC 2 Plus. If there are any programs or modules still 
unsaved you are given the chance to save them before finally quilting. 

Workspace view 

As was briefly mentioned above, BASIC 2 Plus programs may comprise several 'program 
units': one main program and a number of modules (up to nine of which can be active at 
once). Each program unit is stored in a separate file. The workspace view of your program 
shows the names of all the program units together with the files they are stored in. It also 
gives access to the 'Debug command screen' and direct access to the Clipboard. There are 
thus twelve possible Workspace Components' which hold the main program, up to nine 
modules, the Debug command screen and the Clipboard. (The Debug command screen 
contains a list of extra commands which you can have executed at any point in your program. 
Its use will be explained in the next chapter.) 

Selecting Workspace from the View menu will display the Workspace view of your 
program in the Ed i t window. (If the Edit window is closed you won't be able to see this 
view without selecting Show Edit from the Windows menu.) 
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*1 


Workspace 

♦ 

WORKDEM.BAS 

Program 

* C:\INDIWID\MST\WORKDEM.BAS* 

▲ 

HAINNOD.BAS 

Module 

C:\IMDIMID\MST\MftIMMOD.BfiS* 


CALCULE.BAS 

Module 

C:\INDIVID\MST\CALCULE.BAS* 


|)ATA.TXT 

Module 

* C:\INDIVID\MST\DATA.TXT* 


Enpty-4 

Module* 



Empty-5 

Module* 



Empty-6 

Modules 



Empty-7 

Module* 



Empty-8 

Module* 



Empty-9 

Module* 

Debug 

C:\INDIUID\MST\QUICKBUG.BAS* 



Clipboard 

*Y 

Y 


K 


The Workspace view consists of twelve lines, one for each possible workspace component, 
and each line has three parts. 


The first is the name of the program or module currently occupying the component (in the 
case of the Debug command screen and the Oipboard this first part of the line is left blank). 

The second part of the line shows what kind of component it is. It can be any of: 

• Program 

• Module Binary Module 

• Debug 

• Clipboard 

(Binary modules are modules written not in BASIC 2 Plus, but directly in machine code. 
Their use is explained in the Language Reference.) 

The third part of the line gives the name of the file that the component's contents were last 
saved to or loaded from. If any changes have been made (ic. the version held in the 
computer’s memory is different from the version held on disc) the filename is preceded with 
an asterisk. 
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Of the twelve possible workspace components, the Current Workspace Component is the one 
marked by the cursor. Changing the Current Workspace Component is simply a matter of 
clicking the mouse to move the cursor to a new line. It is irrelevant where on the line the 
cursor appears. 

Double-clicking on a line of the workspace view will make that component the current 
component, and immediately display its contents on the Edit screen. Or you can always 
display the contents of the Current Workspace Component by selecting the second option on 
the View menu. This option changes to reflect what the Current Workspace Component is; 
as you move the cursor in the workspace view this option will change to Program, Module, 
Debug, or Clipboard as appropriate. 

You cannot edit a component directly in workspace view, though you can use Copy to 
transfer information to the Clipboard. And for obvious reasons, you cannot use Cut. 
Copy, or Pa s te when you are editing the Clipboard directly. 
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Debugging 


This chapter introduces BASIC 2 Plus's debugging tools, facilities which enable you to test 
your programs thoroughly and efficiently, as well as to track down and correct the bugs. 


Starting and Stopping the Program 

The most necessary of all the debugging tools supplied with BASIC 2 Plus is the means to 
stop a program at any time. There are a number of ways to do this, depending on exactly what 
you want. 

The simplest way to halt a progam temporarily is just to move the pointer into the menu bar. 
This is a feature of GEM rather than BASIC 2 Plus, and it applies to any program which runs 
under GEM. When the program is to continue, just move the pointer back into the main part 
of the screen. 

Since this is a feature of GEM, you can't issue any BASIC 2 Plus commands when the 
program is stopped in this way. Instead, BASIC 2 Plus allows a User Break. When the 
program is running, you can either select Stop from the Program menu, or press G50-C. 
The program will stop tunning and an Alert will appear on the screen with the word Break. 
Click on OK to clear this. The cursor in the Edit window will be positioned at the command 
which was being executed at the time of the break, so that, for example, you can see which 
particular part of the program was taking so long. 

When you want to continue, you can select either Conti nue from the Program menu, 
(which will let the program carry on from the point where it was interrupted) or Re-run, 
which will re-run the program from the beginning. 



CONT 

Use CONT resumes program execution (if possible). 

Syntax CONT 

; 

Note CONT may only be run in Direct Mode. 

• . . 


8909 


BASIC 2 Plus: User Guide & Quick Reference 


23 


Debugging 






Direct Command Debugging 

One of the most important features of the User Break is that you can issue commands while 
the program is temporarily halted. Provided you haven't altered the code at all, you can type 
commands into the Dialogue window and they will be executed immediately. This is 
enormously useful for finding out the values of variables, checking on the amount of free 
memory, etc. The only restriction is that you cannot execute statements which transfer 
control: GOTO. for example, or SUB and FUNCTION calls. 

While it is quite permissible to use the PRINT command to interrogate variables, PRINT 
will send its output to the default stream. (This is the Results-1 window unless you change it.) 
If an essential part of your program concerns the layout of output, it may be inconvenient to 
perform your debug testing with PRINT statements. 

Instead, there is the ? command. This is an easy way of finding out the value of a variable 
without disturbing the Results windows. (It's also quicker to type than PRINT.) The syntax 
is: 

? variable-name 

and this will display the value of the variable in the Dialogue window. You can also use the ? 
command in your program, if you wish; it is one way of putting trace statements into your 
code. However, there is a much better way which uses the Debug command screen, as we 
shall see in a few sections. 

A very useful feature of BASIC 2 Plus is that variables retain their value even after the 
program has finished running. You can interrogate them with the ? command until you either 
amend the program, or execute one of the commands LOAD, NEW, orCLEAR. LOADandNEW 
will be explained in the next chapter. CLEAR is available specifically to clear the values of all 
variables. When you execute it you will see the Information line change back to Di rect 
Command; Clear. 
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Debug Points 

Debug points are special markers that you can put into your program to make BASIC 2 Plus 
carry out certain actions. They perform the job which in other BASICS is done by trace 
statements - special statements put into the program which are only used to track down 
errors. Debug points are better than trace statements for four reasons: 

• Debug statements can be inserted and removed without restarting a program. 

• Alla program's debug points can be activated, deactivated, or removed with one 
command. 

• The commands executed by debug statements do not need to be changed individually. 

• Debug statements can turn tracing on and off. (The section on Tracing explains this fully.) 

There are two stages to using debug points; defining and inserting them, and running the 
program with Debug enabled. 


Inserting and deleting Debug Points 

To insert a debug point, put the cursor where you want to insert it, and select Set Debug 
Poi nt... from the Debug menu. A dialogue will appear giving you two choices of three 
options each. 



Set Debug Point 


Action: |1 


Tracing unchanged 


Turn off tracing 

No action 


Turn on tracing 


| Cancel | 


One choice concerns tracing; it will be explained in the next section. 

The other choice concerns what you want to happen when the program reaches the debug 
point. You can choose between: 

• STOP 

• Action: 1 

• No action 
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The first and last are self-explanatory. The second, if selected, means that at the debug point 
the program will carry out Debug Action number 1. There is a cursor immediately after the 
figure 1 enabling you to change it to another number. You can specify any Action number 
from 1 to 62. 

The action itself is specified in the Debug command screen, which is accessed via the 
Workspace view of the program as follows: 

Select Workspace from the View menu, and double click on the Debug line. The Edit 
window will change to show a window (initially blank) headed with the title Debug. Into this 
screen you can type BASIC 2 Plus commands, each beginning with a line number from 1 to 
62. You cannot use commands which change the flow of control of the program - GOTOs or 
routine calls, for example -but you can have any other command which will fit onto one line: 
IF statements and even SELECT statements are permitted provided you do not exceed the 
limit of 2SS characters. 



You can save the Debug command screen to a file if you wish. Select it in the Workspace 
view to make it the current workspace component and then choose Save... from the File 
menu. You can then load it again at another time by selecting the Debug command screen, 
and choosing Load Debug... from the File menu. 

To delete a debug point, move the cursor to it and select Cl ear Debug Point from the Debug 
menu. Cl ea r all Debug, also on the Debug menu, removes all the debug points from the 
current workspace component 

Note that you can only have one debug point on each statement of the program, and you 
cannot have debug points at all on blank lines. 
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Using Debug Points 

In the Program menu there are seven options which control the debugging of the program: 

• Full speed (or Debug disabled) 

• Debug enabled 

• Show Trace - TROFF 

• Show Trace - TRON 

• Single Step 

• «TROFF» enabled 

• «TROFF» disabled 

The first option is Ful 1 speed only if there are no debug points in the current workspace 
component; it changes to Debug d i s a bl ed as soon as you add any. If cither of these options 
is selected, all debug points are totally ignored. (Of course, if Ful 1 speed is selected, 
there are no debug points to ignore.) The difference between Full speed and Debug 
di sabl ed is that when there are debug points in the program, BASIC 2 Plus has to invest a 
small amount of time looking for them in order to ignore them. Debug di sabl ed thus runs 
slightly slower than Ful 1 speed. 

Debug enabled means that the program obeys STOP and Action commands in debug 
points, but ignores any commands concerning the tracing. 

The remaining options are described in the next section, where tracing is explained fully. 


Tracing 

Often when debugging it is useful to be able to follow the flow of control around a program, 
watching to see which branch of an IF statement is taken, for example, or following a chain 
of subprograms or modules. 

Program tracing provides the way to do this. When tracing is switched on, the program runs 
very slowly so that the statement being processed can be displayed in the Edit window. The 
cursor is always shown on this line, so by following the position of the cursor you can watch 
the flow of control directly. If something happens which you want to investigate, you can 
quickly move the cursor to the menu bar, select Stop, and then enter some direct debug 
commands. 
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Turn trace on and off 


There are two ways to turn tracing on and off: directly, from the Debug menu, or by means of 
Debug points in the program. 

The menu options which control tracing are Show Trace - TROFF and Show Trace - 
TRON. Show Trace - TRON turns tracing on, and Show Trace - TROFF turns it off 
again. The difference between Show Trace - TROFF and Debug enabled is that the 
former allows the tracing to be changed using debug points, whereas the latter always ignores 
all tracing commands. 

The tracing options in debug points should now be self-explanatory. Turn on tracing 
turns tracing on (provided that one of the Show Trace options is selected in the Program 
menu) and Turn off tracing turns it off again. If the tracing is changed by a debug 
point inside a subprogram or module, it reverts to its original value on exit. 

However, debug points which turn tracing off can be overridden. The last two items on the 
Programmenuare<<TROFF>> enabled and <<TR0FF>> disabled .When the second of 
these is selected, all «TR0FF>> debug points are ignored. 


Single Step 


Single step mode enables you to execute your program one statement at a time. 

If you start a program by selecting the second item on the Program menu -Start Step - 
the option Si ngl e Step will automatically be selected in the lower part of that menu before 
the pre-scan of the program. If the pre-scan finds no errors in the program, Start Step 
will change to Step, and you will be able to 'step' through the program, one statement at a 
time, by repeatedly selecting Step (or more likely using its accelerator key (Ml). 

In fact, you can select this option at any time the program is stopped. Hit (Ml. and BASIC 2 
Plus will go into single step mode. Si ngle Step will be selected in the lower part of the 
program menu, and one statement will be executed. When you no longer wish to single step, 
select one of the other options (Full Speed, Debug Disabled. Debug Enabled, 
Show Trace - TROFF or Show Trace TRON) and then select Continue, and the 
program will continue in your chosen mode. 

If you select Continue without choosing one of the above options. Debug Enabled will 
automatically be selected for you. 
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Debug points still operate when the program is in single step mode. Specifically, any 
<<TR0FF>> and <<TR0N>> points will take the program out of single step mode and back 
in again. This means that, for example, you can put a << TR0FF> > point at the beginning of 
each of your routines, so that when single stepping through a program, the trace will skip 
through the routines at full speed, returning to single step again when control returns to the 
main program. 

If you wish to disable this feature, (so that the program continues to single step even if it hits 
a<<TR0FF>>) select <<TR0FF>> disabled at the foot of the Program menu. 


Traceback 


Traceback (not to be confused with trace) is another way of viewing the structure of a 
program. However, it is different from the Workspace view or the Outline view in that it is 
only meaningful while the program is temporarily stopped. 

When you stop a program and select Traceback from the View menu, BASIC 2 Plus 
displays the names of all the active routines, modules, and subroutines (including calls to 
error handling routines and DEF functions) in the order of their calling. Routines which are 
active on more than one level (because of recursion) are displayed an appropriate number of 
times. 

The names are preceded by two numbers separated by a slash. The second of these is the 
number of levels currently active; the first indicates the position of each routine in the 
hierarchy. 
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In the example on the previous page, for instance, the main program has loaded two modules, 
rnunain and test_part. Of these, rnwnain has been called from the main program, 
and is still active. We can sec this, since MODULE rnwna i n is marked as the second active 
call out of ten. 

This module has called main_jnenu, a subprogram which is to be found in MODULE 
rm_main. rnwnain has called run_tests, and so the traceback continues, listing all ten 
active calls. 

Variables in context 

When you're viewing a traceback, you can determine the context in which any ? commands 
are executed. To do this, put the cursor onto the name of the routine or module you want to 
investigate. This makes any ? commands yield the value of variables in the context of that 
routine or module - that is, the value they hold in that routine or module. This context is 
always displayed in the information line, just below the title bar of the Dialogue window. 

So by using traceback you can examine the value of a variable in an active routine even if it 
has the same name as a variable in a nested routine. Furthermore, in a recursive routine you 
can examine the value of a variable at each level of the recursion process. 

If you select a routine in this way, and then switch from the traceback view to the standard 
editing view, the edit window will show the 'traceback context', that is, it will show the 
selected routine with the cursor positioned immediately after the statement which called the 
next routine in the chain. (Obviously this does not apply to the last routine in the chain, since 
it doesn't contain an active call. Instead, the cursor is positioned immediately after the last 
executed statement) 

Traceback is only meaningful if a program is temporarily halted. If you resume execution 
while there is a traceback in view, the traceback window will clear; it will display the new 
traceback stack if the program is stopped again before it terminates. 
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ABS (see Chapter 3) 

A8S is a function which returns the absolute value of its argument. 

ABS (.argument) 

argument is a numeric-expression. 

ACOS (see Chapter 3) 

ACOS is a function which returns the angle whose cosine takes the given value. 
ACOS (.argument) 

argument is a numeric-expression, giving a value in the range -1 ..+1. 

ADDKEY (see Chapter 13) 

ADDKEY adds a new key for the current record. 

ADDKEY [ftjstream-numberf,] new-key ([,] LOCK lock-type] 

new-keyis: KEY key-value ]],] INDEX index-number] 

key-value is an expression, giving a value compatible with the index's key type 

index-number is an integer-expression, giving a value in the range 1..20. 

ADDREC (see Chapter 13) 

ADDREC adds a new record to a Keyed File. 

ADDREC []]]stream-number, string-expression [,] key ][.] LOCK lock-type] 
key is: KEY key-value [[,] INDEX index-number] 

key-value is an expression, giving a value compatible with the index's key type 
index-number is an integer-expression, giving a value in the range 1 ..20. 


ALERT (see Chapter 14) 

Use ALERT produces an alert box on the screen. 

Syntax ALERT icon fJTEXT text-line[, text-line]...],] BUTTON button-spec], button-spec]... 
where: icon is an integer-expression giving a value in the range 0..3, specifying which icon is 
to be used. 

Eachtext-line is a string-expression, giving one line of text tor the body of the alert box. 
Each button-spec is /RETURNJ string-expression , giving the legend for one button. 
Note: References given to the appropriate chapter of the Language Reference Guide. 
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ASC (see Chapter 4) 

Use ASC is a function which converts characters to their numeric character code 
representation. 

Syntax ASC (argument) 

ASIN (see Chapter 3) 

Use AS IN is a function which returns the angle whose sine takes the given value. 
Syntax ASIN (argument) 

where argument is a numeric-expression, giving a value in the range -1 ..+1. 

ATAN & ATN (see Chapter 3) 

Use These functions return the angle whose tangent takes the given value. 

Syntax ATAN (argument) 

AT N( argument) 

where argument is a numeric-expression. 

ATAN2 (see Chapter 3) 

Use ATAN2 is a function which returns the angle between the x axis and the line from 
the origin to the given point. 

Syntax ATAN2(x,y) 
where x and y are numeric-expressions. 

BIN$ (see Chapter 4) 

Use BI NS is a function which converts an integer value to a string of binary digits. 
Syntax BI N$ ( argument(. min-digits)) 

where argument and min-digits are integer-expressions-, min-digits must be in the range 0..32. 

BOX (see Chapter 12) 

Use BOX draws a box on a graphics device. 

Syntax BOX /// stream-number, ] point, width, height ([,] attribute]... 

BUTTON (see Chapter 14) 

Use BUTTON is a function which returns the state of the mouse button. 

Syntax BUTTON [(button-number)] 

where button-number is an integer-expression, giving a value in the range 1 ..15. 
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CALL (see Chapter 6) 

Use CA L L is used to invoke a subprogram. 

Syntax /CALL ]sub-identifier[(.] actual-parameter[, actual-parameter]... ()] 
where sub-identifier is a numeric-identifier corresponding to the sub-identifier of a SUB. 
actual-parameter is expression 

or general-variable 
or actual-array 

actual-array is array-name[ ()/, 

or string-general-variable . record-name . vector-field-name [ ()] 

CALL MODULE (see Chapter 7) 

Use CALL MODULE invokes the body of a module. 

Syntax CALL MODULE module-identifier( ( actual-parameter[, actual-parameter ]...) ] 
where actual-list is actual-parameterl, actual-parameter]... 
actual-parameter is expression 

or general-variable 
or actual-array 

actual-array is array-name (()], 

or string-general-variable . record-name . vector-field-name [ ()] 

CEILING & CEIL (see Chapter 3) 

Use These functions return the value of their argument rounded to an integer. 

Rounding is upwards, that is, towards plus infinity. 

Syntax CEILING(argumen/) 

CEI L( argument) 

where argument is a numeric-expression. 

CHDIR & CD (see Chapter 15) 

Use These statements change the current directory. 

Syntax CHDIR file-name 
CD rest-of-line 

where rest-of-line is everything up to the end of the line 

CHDIR$ (see Chapter 15) 

Use CHDI R$ is a function which returns the current directory. 

Syntax CHDI R$/( drive)] 

where drive is a string-expression, giving a single character string. 
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CHR$ (see Chapter 4) 

Use CHR$ is a function which converts a character code to a single character string. 

Syntax CHR$( argument) 

where argument is an integer-expression in the range 0..255. 

CINT (see Chapter 3) 

Use CI NT is a function which returns the value of its argument rounded to an integer. 

Rounding is towards the nearest integer, with halves being rounded away from 

zero. The result must be in the range -2147483648..+2147483647. 

Syntax Cl NT (argument) 

where argument is a numeric-expression. 

CIRCLE (see Chapter 12) 

Use CIRCLE draws part or all of a circle on a graphics device. 

Syntax - CIRCLE stream-number, ] point, radius [[,] attribute]... 

where attribute is: PART start-angle, end-angle 
or: FILL /ONLY; /WITH nil-style] 
or:WIDTH line-width 
or: STYLE line-style 
or: START line-start-style 
or: END line-end-style 
or: COLOUR colour-number 
or: COLOR colour-number 
or: MODE write-mode 

radius is an integer-expression, giving a positive, non-zero value. 

start-angle and end-angle are numeric-expressions, giving positive, or zero, values. 

CLOSE (see Chapter 8) 

Use CLOSE closes streams. 

Syntax CLOSE 

or CLOSE [fflstream-number [, HHstream-number]... 

CLOSE WINDOW (see Chapter 14) 

Use CLOSE WINDOW closes the specified window. 

Syntax CLOSE WINDOW window-number 

where window-number is an integer-expression, giving a value in the range 1 .. 4 . 
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Syntax 
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Use 

Syntax 


CLEAR (see User Guide Chapter 1) 

CLEAR discards all variables. 

CLEAR 

CLEAR RESET (see Chapter 9) 

CLEAR RESET sets all windows to their initial state, and, in Direct Mode, discards 
all variables. 

CLEAR RESET 

CLS (see Chapters 11 & 12) 

CLS clears a virtual screen. 

CLS /reset; 

CLS [ttjstream-number [[,] RESET] 

CONSOLIDATE (see Chapter 13) 

As soon as a keyed file is changed it is marked "inconsistent". CONSOLIDATE 
causes all outstanding information to be written to the file, and clears the 
"inconsistent marker. 

CONSOLIDATE (ftjstream-number 

CONST (see Chapter 2) 

CONST declares and sets named constants. 

CONST simple-variable - expression [. simple-variable - expression]... 

CONT (see User Guide Chapter 4) 

CONT resumes program execution (if possible). 

CONT 

COS (see Chapter 3) 

COS is a function which returns the cosine of its argument. 

COS (.argument) 

argument is a numeric-expression. 

CURRENCY$ (see Chapter 11) 

CURRENCY! is a function which returns the current "currency string". 
CURRENCY! 
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DATA (see Chapter 2) 

Use DATA is used to include numeric or string data in the code of the program itself, 
rather than inputting it at run time. 

Syntax DATA [data-literalj[. [data-literal]]... 
where data-literal is [sign} numeric-literal 
or string-literal 

or first-char [[character]... last-char] 
sign is + or - 

first-char is any printable character excluding space, comma & double quotes 
character is any printable character excluding comma 
last-char is any printable character excluding space & comma 

DATE (see Chapter 3) 

Use DATE is a function which converts a date in the form of a string to a date as a 
number of days since 31st December 1899. 

Syntax DATE [(argument)] 
where argument is a string-expression. 

DATE$ (see Chapter 4) 

Use DATE) is a function which converts a date as a number of days since 31 st 
December 1899 to a date in the form of a string 

Syntax DATE %[{ argument)] 

where argument is an integer-expression, giving a positive, non-zero, value. 

DECLARE (see Chapter 2) 

Use DECLARE declares simple variables and arrays. 

Syntax DECLARE declared-object [. declared-object ]... 
where declared-object is simple-variable 
or formal-array 

DECLARE CONST (see Chapter 7) 

Use DECLARE CONST declares named constants. 

Syntax DECLARE CONST simple-variable [, simple-variable ]... 













Syntax Summary 


DEC$ (see Chapter 4) 

Use DEC) is a function which converts a numeric value to a formatted decimal string. 
Syntax DEC)(argument, template) 

where argument is a numeric-expression, and template is a string-expression. 

DEF (see Chapter 6) 

Use DEF is used to define an expression function. 

Syntax DEF function-identilier[ ( parameter[, parameter]...) ]- result-expression 
where function-identifier is an identifier, and result-expression is an expression of the same type. 
Each parameter must be a simple-variable. 

DEG (see Chapter 3) 

Use D EG is a function to converts angles in radians to degrees. 

Syntax D EG ( argument ) 
where argument is a numeric-expression. 

DEL (see Chapter 15) 

Use DEL deletes files. (See also ERASE and KILL) 

Syntax DEL rest-of-line 
where file-filter is a string-expression 

rest-of-line is everything up to the end of the line 

DELKEY (see Chapter 13) 

Use DELKEY deletes a key for the current record. 

Syntax DELKEY [l]]stream-number[,] key [[.] LOCK lock-type] 
where key is: KEY key-value ][,] INDEX index-number] 
or: AT position-string 

where key-value is an expression, giving a value compatible with the index’s key type 
index-number is an integer-expression, giving a value in the range 1 ..20. 
position-string is a string-expression, giving a value once returned by POSITION). 
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DIM (see Chapter 2) 

Use DIM is used to specify the size and number of elements in one or more arrays. 

Syntax DIM array-declaration[, array-declaration /... 

where array-declaration is array-name ( dimension-bounds [, dimension-bounds]... ) [storage-class ] 
array-name is an identifier giving the name, and type, of the array 
dimension-bounds is / lower-bound T 0 ]upper-bound 

where lower-bound and upper-bound are both integer-expressions giving values in the 

range -32768..32767 and lower-bound < upper-bound . j 

storage-class is integer-class /KEY/ 

or IEEE4orIEEE8 j 

or FIXED length 

where integer-class is one of BYTE, UBYTE, WORD, UWORD, INTEGER 
length is an integer-expression giving a value in the range 1 ..4096. 

DIMENSIONS (see Chapter 2) 

Use DIMENSIONS is a function used to determine the number of dimensions of ar. 
array. 

Syntax DIMENSIONS(acfua/-array ) 

DIR (see Chapter 15) 

Use DIR produces directory listings. (See also FILES.) 

Syntax DIR rest-of-line 

where rest-of-line is everything up to the end of the line 1 

DISPLAY (see Chapter 15) 

Use DISPLAY lists the contents of a file. (See also TYPE.) 

Syntax DISPLAY [Ifstream-number, ] file-name 

DISTANCE (see Chapter 12) 

Use DISTANCE is a function which returns the distance from the cursor to a given 
point, in user coordinates. 

Syntax DISTANCE( ^stream-number, ] point ) 
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Use 

Syntax 

where 


DO, LOOP (see Chapter 5) 

The 00 statement is used for repeating a sequence of statements when the 
repetition is governed by some condition which may be tested before or after the 
execution of the loop. 

00 [terminating-condition]: loopbody : LOOP [ terminating-condition] 
terminating-conditions are either 
WHILE truth-value 
or UNTIL truth-value 

loopbody is a sequence of BASIC 2 Plus statements, separated in the usual way 
with colons or new lines. 

DRIVE (see Chapter 15) 

DRIVE sets the current drive. 

DRIVE drive 

drive is a string-expression, giving a single character string. 

EDIT (see User Guide Chapter 1) 

EDIT takes you into the edit window. 

EDIT 

ELLIPSE (see Chapter 12) 

ELLIPSE draws part or all of a circle on a graphics device. 

ELLIPSE stream-number, ] point, x-radius, aspect //.] attribute]... 

attribute is: PART start-angle, end-angle 
or: FILL /ONLY] /WITH fill-style] 
or:WIDTH line-width 
or: STYLE line-style 
or: START line-start-style 
or: END line-end-style 
or: COLOUR colour-number 
or: COLOR colour-number 
or: MODE write-mode 

x-radius is an integer-expression, giving a positive, non-zero value. 

aspect is a numeric-expression, giving a positive, non-zero value. 

start-angle and end-angle are numeric-expressions, giving positive, or zero, values. 
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ELLIPTICAL PIE (see Chapter 12) 

Use ELLIPTICAL PIE draws a elliptical "pie" section on a graphics device. 

Syntax ELLIPTICAL PIE $ stream-number, ] point, x-radius, start-angle, end-angle, 
aspect [[,] attribute]... 

where attribute is: FILL /ONLY; /WITH fill-style] 
or: WIDTH line-width 
or: STYLE line-style 
or: COLOUR colour-number 
or: COLOR colour-number 
or: MODE write-mode 

x-radius is an integer-expression, giving a positive, non-zero value. 

aspect is a numeric-expression, giving a positive, non-zero value. 

start-angle and end-angle are numeric-expressions, giving positive, or zero, values. 

END (see Chapter 5) 

Use END is used to terminate execution of the program when it has completed its 
allotted tasks, as opposed to STOP, which is used in debugging. 

Syntax END 

ENVIRONS (see Chapter 15) 

Use ENVI R0N$ is a function which information from the "environment" in the form of a 
string 

Syntax ENVIRON S( argument) 

where argument is either an integer-expression, giving a positive, non-zero, value, 
or a string-expression. 

EOF (see Chapter 10) 

Use EOF is a function, which returns TRUE if there is nothing more to be input from the 
given stream. 

Syntax EOF (]]]]stream-number) 

EPS (see Chapter 3) 

Use EPS is used to give a measure of the significance of a number. 

Syntax EPS (argument) 
where argument is a numeric-expression. 












Syntax Summary 


ERASE (see Chapter 15) 

Use ERASE deletes files. (See also KILL and DEL.) 

Syntax ERASE rest-of-line 

where rest-of-line is everything up to the end of the line 

ERR (see Chapter 16) 

Use E R R is a function which returns the number of the latest error. 

Syntax ERR 

ERROR (see Chapter 16) 

Use ERROR raises an error. 

Syntax ERROR integer-expression 

ERROR$ (see Chapter 16) 

Use ERR0R$ is a function which returns the message associated with an error number. 
Syntax E R RO R $ ( integer-expression) 

EXIT DO, EXIT FOR (see Chapter 5) 

Use EXIT DOandEXIT FOR are used to get out of a loop from the middle without 
waiting for the loop to complete. EXIT DO and EXIT FOR are used to leave DO 
and FOR loops respectively 

Syntax EXIT DO 
or EXIT FOR 

EXIT MODULE (see Chapter 7) 

Use EXIT MODULE is used to leave a module before the final END MODULE 
statement. 

Syntax EXIT MODULE 

EXIT SUB, EXIT FUNCTION (see Chapter 6) 

Use EXIT SUB and EXIT FUNCTION are used to terminate a subprogram or routine 
function before the terminating END SUB or END FUNCTION is reached. 

Syntax EXIT SUB 

or EXIT FUNCTION 
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EXP (see Chapter 3) 

Use EXP is the exponentiation function, the inverse of the natural logarithm. 

Syntax EXP {argument) 
where argument is a numeric-expression. 

EXPORT (see Chapter 7) 

Use EXPORT makes a program's global variables available to any modules it calls. 
Syntax EXPORT exported-object[. exported-object ]... 
where exported-object is simple-variable or formal-array 
formal-array is array-identifier ([,]...) 

EXTENT (see Chapter 12) 

Use The EXTENT function returns the length a string will be when printed. 

Syntax EXTENT (^stream-number, ] string-expression) 

or EXTENT( (ftstream-numberj, J\ print-function [[,]print-function]... [,]string-expression) 

FALSE (see Chapter 3) 

Use FALSE is a function which always returns 0, the value which BASIC 2 Plus deems 
to represent the Boolean value 'false'. (See also OFF.) 

Syntax FALSE 

FD (see Chapter 12) 

Use FD moves the cursor forward a given distance. (See also FORWARD.) 

Syntax [MOVE] FD [ftstream-number, ] distance [[,] attribute]... 
where attribute is: WIDTH line-width 
or: STYLE line-style 
or: START line-start-style 
or: END line-end-style 
or: COLOUR colour-number 
or: COLOR colour-number 
or: MODE write-mode 

distance is an integer-expression, giving a positive, non-zero value. 









Syntax Summary 


FILES (see Chapter 15) 

Use FI LES produces directory listings. (See also DIR.) 

Syntax FILES [[[stream-number, ] [file-filter] 
where file-filter is a string-expression 

FIND$ & FINDDIR$ (see Chapter 15) 

Use These functions are provided for finding files and directories. 

Syntax FIND$(ff/e-ff/ter [, ordinal]) 

FINDDI R$ ( file-filter [, ordinal]) 
where file-filter is a string-expression 

ordinal is an integer-expression, giving a value in the range 1..32767 

FIX (see Chapter 3) 

Use FIX is a function which returns the value otWsargument rounded to an integer. 
Rounding is towards zero. (See also TRUNC.) 

Syntax fix (.argument) 
where argument is a numeric-expression. 

FLOOD (see Chapter 12) 

Use FLOOD fills an area bounded by a given colour. 

Syntax FLOOD # stream-number, ] point, [, boundary-colour] [[,] attribute]... 
where attribute is: FILL WITH fill-style 
or: COLOUR colour-number 
or: COLOR colour-number 
or: MODE write-mode 
boundary-colour is a colour-number. 

NB: FLOOD may have no effect, depending on the device driver. 

FLOOR (see Chapter 3) 

Use The F LOO R function returns the value of itsr argument rounded to an integer. 
Rounding is downwards, that is, towards minus infinity. (See also INT.) 

Syntax FLOOR (argument) 
where argument is a numeric-expression. 
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FONT$ (see Chapter 12) 

Use FONTS is a function which returns the name of a font. 

Syntax FO NT$ ($ stream-number. ] font-ordinal) 

where font-ordinal is an integer-expression, giving a positive, non-zero value. 

FOR (see Chapter 5) 

Use The FOR statement is used to repeat a group of statements where the number of 
repetitions is known or can be calculated at the time the loop is entered. 

Syntax FOR loopcounter - start TO end [STEP stepsize]: loopbody .-NEXT... 
where loopcounter is a simple-variable, not a VAR or ref formal parameter. 
start, end, and stepsize are numeric expressions 

loopbody is a sequence of BASIC 2 Plus statements, separated in the usual way 
with colons or new lines. 

FORWARD (see Chapter 12) 

Use FORWARD moves the cursor forward a given distance. (See also FD.) 

Syntax [MOVE] FORWARD # stream-number, J distance [[,] attribute]... 

[MOVE] FD []]stream-number, ] distance [[.] attribute]... 
where attribute is: WIDTH line-width 
or: STYLE line-style 
or: START line-start-style 
or: END line-end-style 
or: COLOUR colour-number 
or: COLOR colour-number 
or: MODE write-mode 

distance is an integer-expression, giving a positive, non-zero value. 

FRAC (see Chapter 3) 

Use FRAC is a function which returns the fraction part of the value of its argument. 
Syntax FRAC (.argument) 
where argument is a numeric-expression. 

FRE (see User Guide Chapter 1) 

Use FRE is a function which returns the amount of unused memory. 

Syntax FRE 
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Syntax 


FREEFILE (see Chapters) 

FREEFILE is a function which returns on unused stream number. 
FREEFILE 

FUNCTION (see Chapter 6) 

FUNCTION is used to define a routine function. 

FUNCTION function-identifier [( formal-list) ] [ EXPORT ]: 

function-body: 

END FUNCTION 
function-identifier 
formal-list 
formal-functionlist 

simple-var-list 
formal-var-list 
formal-var 
formal-array is 
separator is ; or. 
function-body is a sequence of BASIC 2 Plus statements. 

GET (see Chapter 13) 

GET gets data from Random or Keyed Files. 

GET ft]stream-number, string-general-variable [[.] position] ]],] LOCK lock-type] 
position is as described in POSITION. 

GOSUB (see Chapter 6) 

GOSUB is used to call a subroutine elsewhere in the program. 

GOSUB location 

GOSUB can be spelt as two words thus: GO SUB. 

GOTO (see Chapter 5) 

GOTO is used to jump unconditionally to another part of the program. 

GOTO location 

GOTO may be spelt as two words thus: GO TO 


is identifier, 

is formal-functionlist [ separator formal-functionlist ]... 

is VAL simple-var-list 

or CONST simple-var-list 

or f VARy formal-var-list 

is identifier], identifier]... 

is formal-var], formal-var]... 

is identifier or formal-array 

array-identifier ([,]..■ ) 
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GRAPHICS (see Chapter 12) 

Use GRAPH ICS sets graphics output attributes. 

Syntax GRAPHICS [fctream-number] //,/ attribute]... 

where attribute is: CURSOR cursor-type 

or: FILL /STYLE/ /WITH/ nil-style 
or:/LINE/ WIDTH line-width 
or:/LINE/ STYLE line-style 
or:/LINE/ START line-start-style 
or:/LINE/ END line-end-style 
or: MARKER marker-number 
or:MARKER SIZE marker-size 
or: COLOUR colour-number 
or: COLOR colour-number 
or: MODE write-mode 

where cursor-type is an integer-expression, giving a value in the range 1..3. 

GRAPHICS...RESTORE (see Chapter 12) 

Use GRAPH ICS-RESTORE turns on or off window contents restore. 

Syntax GRAPHICS ]]]stream-number[, ]] RESTORE truth-value 

GRAPHICS...UPDATE (see Chapter 12) 

Use GRAPHICS-UPDATE forces graphics output to be acted on. 

Syntax GRAPHICS [ftstream-numberf, ]] UPDATE /NEW/ 

HEADING (see Chapter 12) 

Use HEADING is a function which returns the current heading. 

Syntax HEADI NG/( []]]stream-number)] 

HEX$ (see Chapter 4) 

Use HEX$ is a function which converts an integer value to a string of hexadecimal 

digits. 

Syntax HEX$ ( argument[, min-digits /) 

where argument and min-digits are integer-expressions ; min-digits must give a value in the range 

0..32. 
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IF (single line version) (see Chapter 5) 

Use This version of the IF statement is used to choose between two courses of 
action. It is retained only for compatibility with earlier versions of BASIC. 

Syntax IF (estvalue[colons /THEN [instructions][[colons ]ELSE elseinstmctions] 
or IF testvalue [colons /GOTO location {[colons /ELSE elseinstmctions] 
where testvalue is a truth-value 

instructions and elseinstmctions are either (a) a line number, or (b) a sequence of 
BASIC statements, each separated by colons 

colons is a sequence of one or more colons, but not new lines. 

IF...END IF (see Chapter 5) 

Use I F...END IF is used to choose between various courses of action depending on 
the values of various expressions. 

Syntax IF testvaluel /: / THEN /: / statementsl[: ] 

/ELSEIF testvalue2 /: /THEN / : ]statements2{:]] 

/ELSEIF testvalue3 [: /THEN /: / statements3[:]] 


/ELSE /: ]elsestatementsl : // 

END IF 

where the testvalues are truth-values, and statementsl, statements2,... and elsestatements are 

sequences of BASIC 2 Plus statements, separated with colons or new lines in the 
usual way. 

IMPORT (see Chapter 7) 

Use IM P 0 RT is used to specify the routines, constants and variables which are 
imported into a program unit from a module. 

Syntax IMPORT / MODULE module-identifier[ ( formal-list ) ]] : 

/ import-declaration : ]... 

END IMPORT 

where module-identifier is a numeric-hJentMer, 

import-declaration is SUB sub-identifier[ ( formal-list )] 

or FUNCTION function-identifier[ ( formal-list ) ] 
or DECLARE CONST simple-var-list 
or DECLARE fdrmal-var-list 
sub-identifier is numeric-identifier 
function-identifier is identifier 
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Syntax 


Use 

Syntax 

or 

where 


Use 

Syntax 

where 


formal-list 

formal-sublist 


simple-var-list 

formal-var-list 

formal-var 

formal-array 

separator 


is formal-sublist [separator formal-sublist ]... 
is VAL simple-var-list 
or CONST simple-var-list 
or /VAR/ formal-var-list 
is identifier[, identifier]... 
is ormal-var[, formal-var]... 
is identifier or formal-array 
is array-identifier (/,/...) 
is ; or, 


INKEY (see Chapter 10) 

INKEY is a function which returns a numeric value corresponding to a key press. 
INKEY 


INKEY$ (see Chapter 10) 

INKEY $ is a function which returns a string value corresponding to a key press. 
INKEYS 


INPUT (see Chapter 10) 

INPUT inputs numeric or string values from sequential input devices. 

INPUT [[[ stream-number[, ]] /AT( column; line)] (;] [prompt] general-variable [. 
general-variable]... [:] 

INPUTS (see Chapter 10) 

INPUTS is a function which returns a string containing a given number of 
characters read from a given stream. 
lHPUT%(.1]stream-number, count) 

INPUTS! count. [[[Jslream-number) 

count is an integer-expression, giving a value in the range 1 ..4096. 

INSTR (see Chapter 4) 

INSTR is a function which is used to find out if one string is a substring of another. 
INSTR (/start, ] search-string , target-string) 

start is an integer-expression in the range 1..4096, and search-string and target-string are 
string-expressions. 
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Syntax Summary 


INT (see Chapter 3) 

Use The I NT function returns the value of itsr argument rounded to an integer. 
Rounding is downwards, that is, towards minus infinity. (See also FLOOR.) 

Syntax I NT (argument) 
where argument is a numeric-expression. 

KEY (see Chapter 13) 

Use KEY is a function which returns the current key value for a Keyed File. 

Syntax K E Y ( [tf]stream-number ) 

KEY$ (see Chapter 13) 

Use K EY $ is a function which returns the current key value for a Keyed File. 

Syntax K EY $ ( Upstream-number) 

KEYSPEC (see Chapter 13) 

Use KEYSPEC creates a new index in a Keyed File, and declares the type of key for 
the index. 

Syntax KEYSPEC upstream-number[.] INDEX index-number [key-spec] [unique] 
where index-number is an integer-expression, giving a value in the range 1 ..20. 
key-spec is:BYTE, UBYTE, WORD. UWORD or INTEGER 
or: FIXED string-length 

where string-length is an integer-expression, giving a value in the range 1 ..30. 
unique is:[,] UNIQUE truth-value 

KILL (see Chapter 15) 

Use KILL deletes files. (See also DEL and ERASE.) 

Syntax KILL file-rilter 
where file-filter is a string-expression 

LABEL (see Chapter 1) 

Use LABE L is used to define a named loaction. 

Syntax LABEL label 
or label: 
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LBOUND (see Chapter 2) 

Use The LBOUND function may be used to determine the lower bound of one of the 
dimensions of an array. (See also LOWER.) 

Syntax LOW E R ( actual-array [, index-number]) 
where index-number must be an integer-expression.in the range 1 to 7. 

LCASE$ (see Chapter 4) 

Use The LCAS E$ function converst characters to lower case. (See also LOWERS.) 
Syntax LCKSZH argument) 
where argument is a string-expression 

LEFT (see Chapter 12) 

Use LEFT changes the current heading. (See also LT, RIGHT and RT.) 

Syntax LEFT $ stream-number, ] angle-change 
where angle-change is a numeric-expression. 

LEFT$ (see Chapter 4) 

Use LEFTS is a function to truncate a string by selecting only its leftmost characters. 
Syntax LEFT$( argument, length) 

where argument is a string-expression and length is an integer-expression returning a value in the 
range 0..4096. 

LEN (see Chapter 4) 

Use LEN is a function to find the length of a string. (How long is a piece of string?) 
Syntax LEN (argument) 
where argument is a string-expression 

LET (see Chapter 2) 

Use LET assigns the value of an expression to a general-variable. 

Syntax ( LET )general-variable - expression 
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LINE (see Chapter 12) 

Use LINE draws a line between two points, possibly via a number of intermediate 
points. 

Syntax LINE $stream-number, ] point, [point, [...point [[,] attribute]... 
where attribute is: WIDTH line-width 
or:STYLE line-style 
or: START line-start-style 
or: END line-end-style 
or: COLOUR colour-number 
or: COLOR colour-number 
or: MODE write-mode 

LINE INPUT (see Chapter 10) 

Use LINE INPUT inputs a complete line from sequential input devices. 

Syntax LINE INPUT [[[stream-number].]][KT(column;line)][:[[prompt]strin&general-variable[;] 
where the [,] following the stream-number is required if none of AT, P ROM PT or the first [; ] 
are present. 

column and line are integer-expressions giving the screen position at which to start the 
prompt etc. 

prompt is prompt-string prompt-separator, 

where prompt-string is PROMPT string-expression or string-literal 

and prompt-separator is , or;. 

LOAD MODULE (see Chapter 7) 

Use LOAD MODULE is used to load a module into rqemory. 

Syntax LOAD MODULE module-identifier, filename 
where module-identifier is numeric-identifier 
filename is string-expression 

LOC (see Chapter 13) 

Use LOC is a function which returns the current record number. 

Syntax LOC ( [[[[stream-number) 

LOCATE (see Chapters 11 & 14) 

Use LOCATE moves to a given character and line position. 

Syntax LOCATE [][stream-number,] column;line 
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LOCK (see Chapter 13) 

Use LOCK sets a new record lock. 

Syntax LOCK (]]]stream-number, lock-type [[,] position] 

LOCK [j]]stream-number {[,] position] [,] LOCK lock-type 
where position is as described in POSITION. 

LOF (see Chapter 13) 

Use LOF returns the length of a file. 

Syntax LO F ( flpstream-number) 

LOG (see Chapter 3) 

Use LOG is a function which returns the logarithm to base e of its argument - the 
natural logarithm. 

Syntax L0G( argument) 

where argument is a numeric-expression, giving a positive, non-zero, value. 

LOG2 (see Chapter 3) 

Use L0G2 is a function which returns the logarithm to base 2 of its argument. 
Syntax L0G2 ( argument) 

where argument is a numeric-expression, giving a positive, non-zero, value. 

LOG10 (see Chapter 3) 

Use L0G10 is a function which returns the logarithm to base 10 of its argument. 
Syntax L0G10 (.argument) 

where argument is a numeric-expression, giving a positive, non-zero, value. 

LOWER (see Chapter 2) 

Use The LOWER function may be used to determine the lower bound of one of the 
dimensions of an array. (See also LBOUND.) 

Syntax LBOUND (actual-array [. index-number]) 
where index-number must be an integer-expression. in the range 1 to 7. 

LOWER$ (see Chapter 4) 

Use The LOWER) functionconverts characters to lower case. (See also LCASE$.) 
Syntax LOWER) (argument) 
where argument is a string-expression 
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LPRINT (see Chapter 11) 

Use LPRINT is just like print, except that the output is always to stream 0. 

Syntax LPRINT [print-item]... 

LSET (see Chapter 4) 

Use LS ET is used to assign to a string-general-variable without changing the length of the 
string it holds. 

Syntax LS ET string-general-variable = string-expression 

LT (see Chapter 12) 

Use LT changes the current heading. (See also LEFT, RIGHT and RT.) 

Syntax LT [\I]stream-number, ] angle-change 
where angle-change is a numeric-expression. 

LTRIM$ (see Chapter 4) 

Use LTRIM$ is a function to remove leading spaces from strings. 

Syntax LTRIMS (argument) 
where argument is a string-expression 

MAX (see Chapter 3) 

Use MAX is a function which returns the value of its largest argument. 

Syntax MAX (argument, argument [. argument]...) 
where argument is numeric-expression. 

MAXNUM (see Chapter 3) 

Use MAXNUM is a function which returns the largest representable number. 

Syntax MAXNUM 

MD (see Chapter 15) 

Use MD makes a new directory. (See also MKDIR.) 

Syntax MD rest-of-line 

where rest-of-line is everything up to the end of the line 
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MID$ - Function (see Chapter 4) 

Use MI D$ is a function to select a substring from a given string. 

Syntax MI D$ ( argument, start [, length ]) 
where argument is a string-expression 

start and length are integer-expressions, start must give a value greater than zero; length 
must give a value greater than or equal to zero. Neither may be greater than 4096. 

MID$ - Statement (see Chapter 4) 

Use MI D$ assigns a string to a substring. 

Syntax MI D$ ( string-general-variable, start [, length ]) - string-expression 

where start and length are integer-expressions, start must give a value greater than zero; length 

must give a value greater than or equal to zero. Neither may be greater than 4096. 

MIN (see Chapter 3) 

Use MIN is a function which returns the value of its smallest argument. 

Syntax MIN( argument, argument(, argument]...) 
where argument is numeric-expression. 

MKDIR (see Chapter 15) 

Use These statements make a new directory. (See also MD.) 

Syntax MO rest-of-line 

where rest-of-line is everything up to the end of the line 

MODULE (see Chapter 7) 

Use MODULE is used to define a module - a program unit which may be accessed and 
executed by a BASIC 2 Plus program. 

Syntax MODULE module-identifier] ( formal-list)] 
module-body 
END MODULE 

MOVE (see Chapter 11) 

Use MOVE moves the graphics cursor. 

Syntax MOVE $ stream-number, ] point 








Syntax Summary 


NAME (see Chapter 15) 

Use NAME changes the name of a file. (See also REN.) 

Syntax NAME old-file-name AS new-file-name 
where old-file-name and new-file-name are file-name s 

NEXT (see Chapter 5) 

Use Terminates the sequence of statements which make up the body of a FOR loop. 
Syntax NEXT (loopcounterl][, [ loopcounter2]](. [ loopcounter3]]... 

OFF (see Chapter 3) 

Use 0 F F is a function which always returns 0, the value which BASIC 2 Plus deems to 
represent the Boolean value false'. (See also FALSE.) 

Syntax OFF 

ON (see Chapter 3) 

Use ON is a function which always returns -1. (See also TRUE.) 

Syntax ON 

ON ERROR (see Chapter 16) 

Use ON ERROR specifies what action is to be taken in the event of an error. 

Syntax ON ERROR STOP 

or ON ERROR GOTO location 

or ON ERROR EXIT place 

where place is MODULE, SUB or FUNCTION, as appropriate. 

ON...GOSUB (see Chapter 6) 

Use Like ON... GOTO, this statement is a relic from older BASICS, included to make 
BASIC 2 plus compatible. 

Syntax ON condition GOSUB [locationl] [, [location2]] [, [locations]] ... 
where condition is an integer-expression 

locationl, location2, locations, ... etc are locations. 
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ON...GOTO (see Chapter 5) 

Use ON... GOTO is a relic from older BASICS, included to make BASIC 2 plus 
compatible. 

Syntax ON condition GOTO [locationl][,[location ]][, / locab'on3]]... 
where condition is an integer-expression 

locationl, locatioM, location,... etc are locations. 

OPEN (see Chapter 8) 

Use OPEN associates a given stream with a device or file. 

Syntax OPEN []]]stream-number [,] WINDOW window-number 

or OPEN [[[Jstream-number [,] INPUT filename [[,] LOCK lock-type] 
or OPEN [[[Jstream-number [.] [exist] OUTPUT filename [[,] LOCK lock-type] 
or OPEN []]]stream-number [,] [exist] APPEND filename [[,] LOCK lock-type] 
or OPEN [[[Jstream-number [,] [exist] RANDOM random-spec [[.] LOCK lock-type] 
or OPEN [l]]stream-number [,] [exist] GRAPHICS filename graphics-spec 
or OPEN []]]stream-number [,] PRINT [printer-number] 
or OPEN []]]stream-number [,] DEVICE device-number 

OPEN...APPEND (see Chapter 8) 

Use OPEN file for output. (See also OPEN...OUTPUT.) 

Syntax OPEN [[]]stream-number [,] [exist] APPEND filename [[,] LOCK lock-type] 
where exist is N E W or 0 LD 

OPEN...DEVICE & OPEN...GRAPHICS (see Chapters) 

Use These forms of OPEN associate a given stream with a GEM graphics device or a 
Metafile. 

Syntax OPEN []]]stream-number [,] DEVICE device-number 

OPEN []]]stream-number [,] [exist] GRAPHICS filename graphics-spec 
where exist is N EW or 0 LD 

device-number is an integer-expression, giving a value in the range 0. .32767. 
graphics-spec is [[,] SIZE m-width,m-height] [[,] SPACE p-width[,p-height]] 
m-width and m-heightare numeric-expressions, giving positive, non-zero, values. 
p-width and p-height are integer-expressions, giving values in the range 1 ..32768. 








Syntax Summary 


OPEN...INPUT (see Chapter 8) 

Use OPEN file for input. 

Syntax OPEN [][]stream-number [,] INPUT filename ([.] LOCK lock-type] 

OPEN...OUTPUT (see Chapter 8) 

Use OPEN file for output. (See also OPEN...APPEND.) 

Syntax OPEN [[[[stream-number [,] [exist] OUTPUT filename [[.] LOCK lock-type] 
where exist is N EW or 0 LO 

OPEN...PRINT (see Chapter 8) 

Use OPEN-PRINT associates a given stream with a simple printer device. 

Syntax OPEN []]]stream-number [,] PRINT [printer-number] 
where print-number is an integer-expression, giving a value in the range 0..5 : 

0 = PRN 

1.. 3 = LPT1 to LPT3 

4.. 5 = COM1 to COM2 

OPEN...RANDOM (see Chapter 13) 

Use OPEN-RANDOM associates a given stream with a random or keyed file. 
Syntax OPEN [[[[stream-number [,] [exist] RANDOM random-spec [[,] LOCK lock-type] 
where random-spec is filename [[,] INDEX filename] [[,] LENGTH record-length] 
record-length is an integer-expression, giving a value in the range 1..4096. 

OPEN...WINDOW (see Chapter 8) 

Use OPEN-WINDOW associates a given stream with a given screen window. 
Syntax OPEN [[[]stream-number [,] WINDOW window-number 
where window-number is an integer-expression, giving a value in the range 1 ..4. 

OSERR (see Chapter 16) 

Use OSERR is a function which gives more information about the latest "operating 
system dependent" error. 

Syntax OSERR 
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PI (see Chapter 3) 

Use PI is a function which returns the representable value closest to the mathematical 
constant it. 

Syntax PI 

PIE (see Chapter 12) 

Use PIE draws a circular "pie" section on a graphics device. 

Syntax PIE ftstream-number, J point, radius, start-angle, end-angle [[,] attribute]... 
where attribute is: FILL /ONLY) /WITH till-style] 
or:WIDTH line-width 
or: STYLE line-style 
or: COLOUR colour-number 
or: COLOR colour-number 
or: MODE write-mode 

radius is an integer-expression, giving a positive, non-zero value. 

start-angle and end-angle are numeric-expressions, giving positive, or zero, values. 

PLOT (see Chapter 12) 

Use PLOT plots "markers" at the points given. 

Syntax PLOT ftstream-number. ] point [. point]... [[,] attribute]... 
where attribute is: MARKER marker-number 
or: SIZE marker-size 
or: COLOUR colour-number 
or: COLOR colour-number 
or: MODE write-mode 

POINT (see Chapter 12) 

Use POINT sets a new current heading. 

Syntax POINT ftstream-number, ] angle 
where angle is a numeric-expression. 

POINTSIZE (see Chapter 12) 

Use POINTSIZE is a function which returns an available size of a font. 

Syntax POINTSIZE( ftstream-number, ] font-ordinal, point-size) 

where font-ordinal and point-size are integer-expressions, giving positive, non-zero values. 







Syntax Summary 


POS (see Chapters 9 & 12) 

Use These function return the current cursor position in characters and lines. (See 
also VPOS) 

Syntax POS [{[][]stream-number)] 

POSITION (see Chapter 13) 

Use POSITION moves to a new position in a Random or Keyed file. 

Syntax POSITION [[]]stream-number [,] position [[,] LOCK lock-type] 
where position is: NEXT 

or: AT record-number 
or: AT position-string 

or: KEY key-value [[,] INDEX index-number] 
or: IN D E X index-number 

where key-value is an expression, giving a value compatible with the index's key type. 
index-number is an integer-expression, giving a value in the range 1 ..20. 
position-string is a string-expression, giving a value once returned by POSITIONS. 

POSITIONS (see Chapter 13) 

Use POSITIONS is a function which returns a string which unambiguously specifies 
the current position. 

Syntax POSITION %(.[[]]stream-number) 


PRINT (see Chapter 11) 

Use PRINT outputs numbers and strings. 

Syntax PRINT []]stream-number[.]] [print-item]... 

where the [,] following the stream-number is required if the first print-item is an expression. 
each print-item may be: expression 
or separator 

or print-command- see Print Commands box 
or print-function-see Print Functions box 
or USING string-expression : 

provided that no expression immediately follows another. 
separator is , or: 




ini 
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PRINT COMMANDS (see Chapter 11) 

Use These may be used in PRINT or LPRINT statements. 

Syntax AT (column; line) 

T A B ( integer-expression) 

ADJUST ( integer-expression) 

PRINT FUNCTIONS (see Chapter 11) 

Use These may be used in PRINT or LPRINT statements, and in the EXTENT function. 
Syntax ZONE (integer-expression) 

MARGIN ( integer-expression) 

EFFECTS! integer-expression, integer-expression) 

MODE! write-mode) 

COLOUR! colour-number) 

COLOR! colour-number) 

FONT ( font-ordinal) 

POI NTS (.point-size) 

ANGLE ( integer-expression) 

PROGPATH$ & PROGFILE$ (see Chapter 7) 

Use These functions return the current file name of the main program. 

Syntax PR0GPATH$ 

PR0GFILE$ 

PUT (see Chapter 13) 

Use PUT puts data to Random or Keyed Files. 

Syntax PUT /// Jstream-number, string-expression [[,] position] [(,] LOCK lock-type] 
where position is as described in POSITI ON. 

QUIT (see User Guide Chapter 1) 

Use SYSTEM takes you out of BASIC 2 Plus. (See also SYSTEM.) 

Syntax SYSTEM 
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Syntax Summary 


RAD (see Chapter 3) 

Use RAD is a function to converts angles in degrees to radians. 

Syntax RA D ( argument ) 
where argument is a numeric-expression. 

RANDOMIZE (see Chapter 3) 

Use RANDOMIZE is used to set the seed for BASIC 2 Plus's pseudo-random number 
generator. 

Syntax RANDOMIZE [seed-value] 
where seed-value is a numeric-expression. 

RD (see Chapter 15) 

Use These statements delete (remove) a directory. (See also RMDIR.) 

Syntax RD rest-of-line 

where rest-of-line is everything up to the end of the line 

READ (see Chapter 2) 

Use READ is used to read data from a DATA statement into general-variables. 

Syntax READ general-variable [, general-variable] ... 

RECORD (see Chapter 2) 

Use RECORD is used to specify a record structure which can be imposed on strings. 
Syntax RECORD record-name ; field-definition[, field-definition]... 
where field-definition is: numeric-field-name [vector-field][storage-class] 

or: string-field-name [vector-field] FIXED length 
numeric-field-name is a numeric-identifier, giving the name of a numeric field 
string-field-name is a string-identifier, giving the name of string field 
vector-field is (.dimension-bounds) 

or [ dimension-bounds ] 
where dimension-bounds is as in DIM. 
storage-class is integer-class [KEY] 

or IEEE4orIEEE8 

where integer-class is one of BYTE, UBYTE, WORD, UWORD, INTEGER 
length is an integer-expression giving a value in the range 1..4096. 
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REN (see Chapter 15) 

Use REN changes the name of a file. (See also NAME.) 

Syntax REN rest-oNine 

where rest-oNine is everything up to the end of the line 

REPEAT (see Chapter 5) 

Use The REPEAT statement is used for repeating a sequence of statements when the 
repetition is governed by some condition which may be tested before or after the 
execution of the loop. 

Syntax REPEAT : loopbody: UNTIL condition 
where condition is a truth-value 

loopbody is a sequence of BASIC 2 Plus statements, separated in the usual way 
with colons or new lines. 

REPOSITION (see Chapter 13) 

Use REPOSITION moves to a new position in a Keyed file, without changing record. 
Syntax REPOSITION $]stream-number [,] key ff.J LOCK lock-type] 
where toy is: KEY key-value [[,] INDEX index-number] 

where key-value is an expression, giving a value compatible with the index's key type 
index-number is an integer-expression, giving a value in the range 1 ..20. 

RESTORE (see Chapter 2) 

Use RESTORE is used to explicitly move the pointer which indicates the next DAT A item 
to be read in. 

Syntax RESTORE ( location ] 

RESUME (see Chapter 16) 

Use RESUME signals the end of "error state". 

Syntax RESUME 

or RESUME NEXT 
or RESUME EXIT place 
or RESUME location 
or RESUME STOP 

where place is MODULE, SUB or FUNCTION, as appropriate. 


62 


8909 








Syntax Summary 


RETURN (see Chapter 6) 

Use RETURN is used to terminate a subroutine. 

Syntax RETURN 

RIGHT (see Chapter T2) 

Use These statements change the current heading. (See also RT, LEFT and LT.) 
Syntax RIGHT §stream-number. ] angle-change 
where angle-change is a numeric-expression. 

RIGHT$ (see Chapter 4) 

Use RIGHTS is a function to truncate a string by selecting only its rightmost 
characters. 

Syntax RIGHTS! argument, lenglh) 

where argument is a string-expression and length Is an integer-expression returning a value in the 
range 0..4096. 

RMDIR (see Chapter 15) 

Use RMDIR deletes (removes) a directory. (See also RMDIR.) 

Syntax RD rest-of-line 

where rest-of-line is everything up to the end of the line 

RND (see Chapter 3) 

Use RND is a function which returns a pseudo-random number. 

Syntax RND [(argument)] 

where argument is an integer-expression, giving a value in the range 1 ..65535. 

ROUND (see Chapter 3) 

Use ROUND is function which returns the value of its argument rounded to a specific 
number of decimal places. 

Syntax ROUND! argument[, rounding]) 

where argument is a numeric-expression and rounding is an integer-expression. 
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RSET (see Chapter 4) 

Use RS ET is used to assign to a string-general-variable without changing the length of the 
string it holds. 

Syntax RSET string-general-variable = string-expression 

RT (see Chapter 12) 

Use RT changes the current heading. (See also RIGHT, :LEFT and LT.) 

Syntax RT fflstream-number, J angle-change 
where angle-change is a numeric-expression. 

RTRIM$ (see Chapter 4) 

Use RTRIMJ is a function to remove trailing spaces from strings. 

Syntax RTRIM M argument) 
where argument is a string-expression 

RUN (see User Guide Chapter 1) 

Use RUN starts executing the current program. 

Syntax RUN 

SCREEN (see Chapter 9) 

Use SCREEN sets the type and size of a Virtual Screen 
Syntax SCREEN fit stream-number [,]] GRAPHICS fsize] [[,] window-attribute]... 

SCREEN [Ifstream-number [.]] TEXT [size] [[,] window-attribute]... 

SCREEN fIf stream-number [,]} TEXT FLEXIBLE [[,] window-attribute]... 
where size is width [FIXED], height [FIXED] 

window-attribute is: MAXIMUM width, height 
or: MINIMUM width, height 
or: UNIT width, height 
or: INFORMATION truth-value 

width and height are integer-expressions, giving positive, non-zero values. 












Syntax Summary 


SELECT CASE (see Chapter 5) 

Use SELECT CASE is used to choose one course of action from several, the choice 
being determined by the value of a given expression. 

Syntax SELECT CASE selector-expression[:] 

[CASE testvaluesl f. testvaluesla][ , testvalueslb ]... : statementsl : ] 

/CASE testvalues2[, testvalues2a][. testvalues2b ]... : statement : ] 


[CASE ELSE : elsestatements : ] 

END SELECT 

where statementsl, statements2, statements3, .... and elsestatements are sequences of BASIC 
statements separated by colons or new lines in the usual way 
testvalues may be either of the form 
expression [ TO end-expression ] 
or IS relation limit-expression 

where all the expressions must be of the same type as selector-expression. 

SELECTOR (see Chapter 15) 

Use SELECTOR runs an "item" selector dialogue. 

Syntax SELECTOR directory-string [. selection-string] 
or SELECTOR . selection-string 

SELPATH$ & SELFILE$ & SELWILD$ (see Chapter 15) 

Use These functions return parts of the values stored for the SELECTOR dialogue. 
Syntax SELPATHS 
SELFILE$ 

SELWILDS 


8909 


BASIC 2 Plus: User Guide & Quick Reference 



65 








SET (see Chapter 12) 

Use SET changes the text output attributes for a given stream. 

Syntax SET [ftstream-number[,]J text-attribute ft.Jtext-attribute]... 
where each text-attribute may be one of: 

ZONE zone-size 

MARGIN margin-position 

EFFECTS effects-on, effects-off 

MODE write-mode 

COLOUR colour-number 

COLOR colour-number 

FONT font-ordinal 

POINTS point-size 

ANGLE text-angle 

WRAP truth-value 

SGN (see Chapter 3) 

Use SGN is a function which returns the sign of the value of its argument. 

Syntax SGN( argument) 
where argument is a numeric-expression. 

SHAPE (see Chapter 12) 

Use SHAPE draws a polygon shape. 

Syntax SHAPE [ftstream-number, ] point, point, point [, point]... ft,] attribute]... 

where attribute is: FILL /ONLY; /WITH fill-style] 
or:WIDTH line-width 
or: STYLE line-style 
or: COLOUR colour-number 
or: COLOR colour-number 
or: MODE write-mode 

SHARED (see Chapter 6) 

Use SHARED makes global variables directly available to routines. 

Syntax SHARED shared-object[, shared-object]... 

where formal-var is simple-variable or array-identifier ( [, ]... )or array-identifier [ f. ]... ] 







I 


Syntax Summary 


Use 

Syntax 

where 


Use 

Syntax 

where 


Use 

Syntax 


Use 

Syntax 

where 


Use 

Statement Syntax 
Function Syntax 


Use 

Syntax 

where 


SIN (see Chapter 3) 

SIN is a function which returns the sine of its argument. 

SIN ( argument) 

argument is a numeric-expression. 

SQR (see Chapter 3) 

SQR is a function which returns the (positive) square root of its argument. 

SQR (argument) 

argument is a numeric-expression, returning a positive, or zero value. 

STOP (see Chapter 5) 

STOP is used to halt the execution of the program in a condition where the 
variables can be inspected or altered. 

STOP 

STR$ (see Chapter 3) 

STR$ is a function to convert a numeric value to string form. 

STR $( argument) 

argument is a numeric-expression. 

STREAM (see Chapter 8) 

The STREAM statement changes the default stream. The STREAM function returns 
the current stream. 

STREAM [fflstream-number 
STREAM 

STRINGS (see Chapter 4) 

STRI NG$ is a function to generate a string of repeated characters. 

STRINGS (.length , argument) 

length is an integer-expression in the range 0..4096 and argument is a non-null string- 
expression or an integer-expression giving a value in the range 0..255. 
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Use SUB is used to define a subprogram. 


Syntax SUB sub-identifier[ ( formal-list) ] [EXPORT ] 
sub-body: 

END SUB 

where sub-identifier is a name 

sub-body is a sequence of BASIC 2 Plus statements, separated with colons or new 
lines in the usual way. 

SWAP (see Chapter 2) 

Use SWAP exchanges the values of two general variables. 

Syntax SWAP general-variable, general-variable 

SYSTEM (see User Guide Chapter 1) 


Use SYSTEM takes you out of BASIC 2 Plus. (See also QUIT.) 

Syntax SYSTEM 

TAN (see Chapter 3) 

Use TAN is a function which returns the tangent of its argument. 

Syntax TAN (argument) 
where argument is a numeric-expression. 

TEST (see Chapters 9 & 12) 

Use TEST is a function which returns the colour of a point on a Graphics Screen. 
Syntax T EST (. [ft stream-number. ] point) 

NB: TEST may have no effect, depending on the device driver. 

TEXT (see Chapter 11) 

Use TEXT performs various operations available on text screens. 

Syntax TEXT [ftstream-number,] CLEAR dear-area 
or TEXT [ftstream-number,] DELETE /LINE) 
or TEXT [ftstream-number,] INSERT /LINE] 
or TEXT /// stream-number,] FEED count 
where dear-area is one of EOL, BOL, LINE, EOS, BOS, SCREEN 
count is an integer-expression. 
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Syntax Summary 


TIME (see Chapter 3) 

Use TIM E is a function which returns the number of hundredths of a second which 
have elapsed since midnight, to the nearest hundredth. 

Syntax TIME 

TIME$ (see Chapter 4) 

Use TI ME$ is a function which returns the number of hundredths of a second which 
have elapsed since midnight, to the nearest hundredth, in the form of a string. 

Syntax TIMES 

TIMER (see Chapter 3) 

Use TIM E R is a function which gives the number of seconds which have elapsed since 
midnight. 

Syntax TIMER 

TOWARD (see Chapter 12) 

Use TOWARD is a function which returns the heading from the cursor to a given point. 
Syntax TOWARD( [^stream-number, ] point) 

TRUE (see Chapter 3) 

Use TRUE is a functios which always returns -1. (See also ON.) 

Syntax TRUE 

TRUNC (see Chapter 3) 

Use TRUNC is a function which returns the value of their argument rounded to an 
integer. Rounding is towards zero. (See also FIX.) 

Syntax T RU N C ( argument) 
where argument is a numeric-expression. 

TYPE (see Chapter 15) 

Use TYPE lists the contents of a file. (See also DISPLAY.) 

Syntax TYPE rest-of-line 

where rest-of-line is everything up to the end of the line. 
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UBOUND (see Chapter 2) 

Use UBOUND may used to determine the upper bound of one of the dimensions of an 
array. (See also UPPER.) 

Syntax UB0UND( actual-array[. index-number]) 
where index-number must be an integer-expressionAn the range 1 to 7. 

UCASE$ (see Chapter 4) 

Use UCASES converts characters to upper case. (See also UPPERS.) 

Syntax UCASE % l argument) 
where argument is a string-expression 

UNIQUE (see Chapter 13) 

Use UNIQUE is a function which returns the next "unique" number for a Keyed File. 
Syntax UNIQUE! Upstream-number) 

UNLOAD (see Chapter 7) 

Use UNLOAD MODULE is used to unload a module. 

Syntax UNLOAD MODULE module-identirier 

UPPER (see Chapter 2) 

Use UPPER may used to determine the upper bound of one of the dimensions of an 
array. (See also UBOUND.) 

Syntax U P P E R ( actual-array [. index-number]) 

UPPER$ (see Chapter 4) 

Use UPPERS converts characters to upper case. (See also UCASE$.) 

Syntax UPPERS (argument) 
where argument is a string-expression 

USER...ORIGIN (see Chapter 12) 

Use USER-ORIGIN changes where the origin of user coordinate space appears on the 
device. 

Syntax USER [Ihtream-number] ORIGIN point 








I Syntax Summary 


USER...SPACE (see Chapter 12) 

Use USER-SPACE sets the extent of the user coordinate space. 

Syntax USER (]] stream-number] SPACE width[, height] 
where width and height are integer-expressions, giving positive, non-zero values, 
where index-number must be an integer-expression.m the range 1 to 7. 

VAL (see Chapter 3) 

Use VAL converts the string representation of a number to its numeric value. 

Syntax VAL (.argument) 
where argument is a string-expression. 

VERSION (see Chapter 15) 

Use VERSION is a function which returns vesrion information. 

Syntax VERS I ON (query) 

where query is an integer-expression, giving a value in the range 0..4. 

VPOS (see Chapters 9 & 12) 

Use VPOS returns the current cursor position in characters and lines. (See also POS) 
Syntax V P0S[( [#]stream-number)] 

WHILE (see Chapter 5) 

Use The WHILE statement is used for repeating a sequence of statements when the 
repetition is governed by some condition which may be tested before or after the 
execution of the loop. 

Syntax WHILE condition : loopbody : WEND 
where condition is a truth-value 

loopbody is a sequence of BASIC 2 Plus statements, separated in the usual way 
with colons or new lines. 

WHOLES (see Chapter 4) 

Use WHOLE$ is a function which returns the whole of a fixed-length string. 

Syntax WHOLE argument) 
where argument is a string-expression 
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WINDOW (see Chapter 14) 

Use WINDOW statements change the size, position etc. of Screen Windows. 

Syntax WINDOW (ftstream-number] CLOSE 

or WINDOW (ftstream-number,] FULL truth-value 
or WINDOW (ftstream-number] OPEN 
or WINDOW (ftstream-number] SIZE width, height 
or WINDOW (ftstream-number] PLACE point 
or WINDOW [ftstream-number] TITLE string-expression 
or WINDOW [ftstream-number] INFORMATION string-expression 
or WINDOW [ftstream-number] MOUSE mouse-form 
or WINDOW ft]stream-number] CURSOR truth-value 
or WINDOW (ftstream-number] SCROLL point 
where mouse-torm is an integer-expression, giving a value in the range 0.7 
width and height are integer-expressions, giving a value 1 ..5000 

XACTUAL & YACTUAL (see Chapter 14) 

Use XACTUAL and YACTUAL are functions which return the actual size of a window, in 
screen device pixels. 

Syntax XAC TU A Lf( (ft]stream-number) ] 

YAC TU A L/( lftjstream-number) ] 

XBAR & YBAR (see Chapter 14) 

Use XBAR and YBAR are functions which return the actual size of the scroll barsof a 
window, in screen device pixels. 

Syntax X B A R/( (ft]stream-number) ] 

Y B A R/( (ftjstream-number) ] 

XCELL & YCELL (see Chapter 12) 

Use XCELL and YCELL are functions which return the size of a character cell, in user 
coordinates. 

Syntax KELL(((ft]stream-number)] 

YCELL/C lftjstream-number ) ] 
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Syntax Summary 


Use 

Syntax 

Use 

Syntax 

Use 

Syntax 

Use 

Syntax 

Use 

Syntax 

Use 

Syntax 


XDEVICE & YDEVICE (see Chapters 9 & 12) 

XDEVICE and YDEV ICE are functions which return the size of a graphics device, 
in device pixels. 

XDEV ICE/( [ft]stream-number) ] 

Y D E VIC E/( [ft]stream-number) ] 

XMETRES & YMETRES (see Chapters 9 & 12) 

XMETRES and YMETRES are functions which return the size of a graphics device, 
in metres. 

XMETRES/Y [ft]stream-number)] 

YMETRES^ [ftjstream-number)] 

XMOUSE & YMOUSE (see Chapter 14) 

These functions return the current position of the mouse pointer, in screen device 

pixels. 

XMOUSE 

YMOUSE 

XPIXEL & YPIXEL (see Chapters 9 & 12) 

XPIXEL and Y PIXEL are functions which return the size of a device pixel, in user 
coordinates. 

XPIXEL/( [i[[stream-number)] 

Y PIX E L(( [ftjstream-number)] 

XPLACE & YPLACE (see Chapter 14) 

XPLACE and YPLACE are functions which return the position of the bottom left 
hand corner of a window, in screen device pixels. 

X P LAC E/( [ftjstream-number)] 

Y P LAC E/( [ftjstream-number)] 

XPOS & YPOS (see Chapters 9 & 12) 

XPOS and Y POS are functions which return the current cursor position, in user 
coordinates. 

X P 0 S/( [ftjstream-number) ] 

YP0S[( [ftjstream-number) ] 
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XSCROLL & YSCROLL (see Chapter 14) 

Use XSCROLL and YSCROLL are functions which return the position of the window on 
the virtual screen, in user coordinates. 

Syntax XSCROLL/l fflstream-numbet)] 

YSCROLL/! (ipstream-number) J 

XUSABLE & YUSABLE (see Chapter 9) 

Use XUSABLE and YUSABLE are functions which return the usable size of a graphics 
device, in device pixels. 

Syntax XUSAB LE/( Upstream-number)] 

YUSABLE/! //// stream-number) ] 

XVIRTUAL & YVIRTUAL (see Chapter 9) 

Use XVIRTUAL and YVIRTUAL are functions which return the size of a graphics virtual 
screen, or other graphics device, in user coordinates.. 

Syntax XVIRTU A L/( [Ipstream-number) ] 

YVIRTUAL/! (ipstream-number) ] 

XWINDOW & YWINDOW (see Chapter 14) 

Use XWINDOW and YWINDOW are functions which return the size of a window, in screen 
device pixels. 

Syntax X WIN D0W/( [ipstream-number)] 

Y WIN D0W/( [ipstream-number) ] 

YASPECT (see Chapters 9 & 12) 

Use YASPECT is a function which gives the aspect ratio of a user coordinate pixel. 
Syntax YASPECT/! [ipstream-number)] 

ZONE (see Chapter 11) 

Use ZONE sets the print zone size for the Dialogue Screen. 

Syntax ZONE zone-size 









Keywords 


ABS 

CINT 

DO 

ACOS 

CIRCLE 

DRIVE 

ADDKEY 

CLEAR 

EDIT 

ADDREC 

CLOSE 

EFFECTS 

ADJUST 

CLS 

ELLIPSE 

ALERT 

COLOR 

ELLIPTICAL 

AND 

COLOUR 

ELSE 

ANGLE 

CONSOLIDATE 

ELSEIF 

APPEND 

CONT 

END 

ARC 

COS 

ENVIRONS 

AS 

CURRENCYS 

EOF 

ASC 

CURSOR 

EOL 

ASIN 

DATA 

EOS 

AT 

DATE 

EPS 

ATAN 

DATES 

ERASE 

ATAN2 

DECS 

ERR 

ATN 

DECIMAL 

ERROR 

BINS 

DECLARE 

ERRORS 

BOL 

DEF 

EXIT 

BOX 

DEG 

EXP 

BUTTON 

DEGREES 

EXPORT 

BYTE 

DEL 

EXTENT 

CALL 

DELETE 

FALSE 

CASE 

DELKEY 

FD 

CD 

DEVICE 

FEED 

CEIL 

DIM 

FILES 

CEILING 

DIMENSIONS 

FILL 

CHOIR 

DIR 

FINDS 

CHOIRS 

DISPLAY 

FINDDIRS 

CHRS 

DISTANCE 

FIX 


8909 


FIXED 

INSTR 

FLEXIBLE 

I NT 

FLOOD 

INTEGER 

FLOOR 

IS 

FONT 

KEY 

FONTS 

KEYUS 

FOR 

KEYSPEC 

FORWARD 

KILL 

FRAC 

LABEL 

FRE 

LBOUND 

FREEFILE 

LCASES 

FULL 

LEFT 

FUNCTION 

LEFTS 

GET 

LEN 

GOSUB 

LENGTH 

GO 

LET 

GOTO 

LINE 

GRAPHICS 

LOAD 

HEADING 

LOC 

HEXS 

LOCATE 

IF 

LOCK 

IMPORT 

LOF 

INDEX 

LOG 

INF 

LOG 10 

INFORMATION 

LOOP 

INKEY 

LOWER 

INKEYS 

LOWERS 

INPUT 

LPRINT 

INPUTS 

LSET 

INSERT 

LTR1MS 



BASIC 2 Plus: User Guide & Quick Reference 


75 






MARGIN 

PLOT 

RT 

TIME 

WORD 

MARKER 

POINT 

RTRIMS 

TIMES 

WRAP 

MAX 

POINTS 

RUN 

TIMER 

XACTUAL 

MAXIMUM 

POINTSIZE 

SCREEN 

TITLE 

XBAR 

MAXNUM 

POS 

SCROLL 

TO 

XCELL 

MIN 

POSITION 

SELECT 

TOWARD 

XDEVICE 

MINIMUM 

POSITIONS 

SELECTOR 

TRAP 

XMETRES 

MD 

PRINT 

SELFILES 

TRUE 

XOR 

MIDS$ 

PROMPT 

SELPATHS 

TRUNC 

XPIXEL 

MKDIR 

PUT 

SELWILDS 

TYPE 

XPLACE 

MOD 

QUIT 

SET 

UBOUND 

XPOS 

MODE 

RAO 

SGN 

UBYTE 

XSCROLL 

MODULE 

RADIAN 

SHAPE 

UCASES 

XUSABLE 

MOUSE 

RANDOM 

SHARED 

UNIQUE 

XVIRTUAL 

MOVE 

RANDOMIZE 

SIN 

UNIT 

XWINDOW 

NAME 

RD 

SIZE 

UNLOAD 

YACTUAL 

NEW 

READ 

SPACE 

UNTIL 

YEAR 

NEXT 

RECORD 

SQR 

UPDATE 

YCELL 

NOT 

REM 

START 

UPPER 

YDEVICE 

OFF 

REN 

STEP 

UPPERS 

YMETRES 

OLD 

REPEAT 

STOP 

USER 

YOR 

ON 

REPOSITION 

STRS 

USING 

YPIYEL 

ONLY 

RESET 

STREAM 

UWORD 

YPLACE 

OPEN 

RESTORE 

STRINGS 

VAL 

YPOS 

OPTION 

RESUME 

STYLE 

VAR 

YSCROLL 

OR 

RETURN 

SUB 

VERSION 

YUSABLE 

ORIGIN 

RIGHT 

SWAP 

VPOS 

YVIRTUAL 

OSERR 

RIGHTS 

SYSTEM 

WEND 

YWINDOW 

OUTPUT 

RMDIR 

TAB 

WHILE 

ZONE 

PART 

RND 

TAN 

WHOLES 


PI 

ROUND 

TEST 

WIDTH 


PIE 

ROUNDED 

TEXT 

WINDOW 


PLACE 

RSET 

THEN 

WITH 



76 


8909 










Important Notice 


THE SOFTWARE CONTAINED IN THE DISKETTE PACKAGE IS SUPPLIED TO 
YOU ON THE TERMS AND CONDITIONS INDICATED BELOW. THE OPENING 
OF THIS PACKAGE INDICATES YOUR ACCEPTANCE OF THESE TERMS AND 
CONDITIONS. IF SUCH TERMS AND CONDITIONS ARE NOT ACCEPTED BY 
YOU, YOU MUST RETURN THE UNOPENED PACKAGE TO THE PLACE OF 
PURCHASE AND YOUR MONEY WILL BE REFUNDED. NO REFUNDS WILL BE 
GIVEN WHERE THE PACKAGE HAS BEEN OPENED UNLESS THE PRODUCT 
IS FAULTY AND SUCH REFUND BECOMES PAYABLE UNDER CLAUSE 7 
BELOW 

In this notice, the terms: 

‘Locomotive’ means Locomotive Software Limited 

‘The Program’ means the programs known as B2PLUS.RSC and B2PLUS.APP on the 
diskette supplied in the diskette package. 

1. Copyright 

Material within The Program is copyright Locomotive. 

Locomotive grants to the purchaser of this package a non-exclusive right to use The Program 
in accordance with these terms and conditions. Such Licence may be transferred only in 
accordance with Clause 3 below. Any other use or dealing not expressly authorised by these 
terms and conditions is strictly prohibited. 

2. Use 

The Program may only be used on a single machine or terminal at any one time but may be 
copied in support of that use. Any such copying is subject to there being no modification of 
The Program and in particular to the copyright notices of Locomotive being preserved in the 
copy. Save for copying as aforesaid, any other operations (including modification or 
translation from machine readable form) are expressly prohibited. 

3. Transfer 

The Program may be transferred to a third party provided the original and all copies arc 
transferred or otherwise destroyed and provided further these terms and conditions are 
produced to that third party and prior to the transfer that party agrees and undertakes to 
observe and continue to observe the same. Without such transfer and undertaking any 
application of The Program or copies thereof by any other person will not be authorised by 
Locomotive and will be in breach of Locomotive’s copyright and other proprietary rights. 
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4. Documentation 


The documentation accompanying The Program is copyright Locomotive. However, no right 
to reproduce that documentation in part or in whole is granted by Locomotive. Should 
additional copies of the documentation be required for whatever reason, application must be 
made in writing to Locomotive which will be considered in its discretion. 

5. Breach 

If the user for the time being acts in breach of any of these terms and conditions it shall 
indemnify Locomotive against all loss suffered (including loss of profits) and the licence 
granted hereunder shall be deemed to be terminated forthwith. On termination the user shall 
deliver up to Locomotive all infringing and lawful copies of The Program. 

6 . Exclusions 

Neither Locomotive nor any person authorised by it gives warranties or makes 
representations that The Program is error free or will meet functions required by the user. It 
shall be the responsibility of the user to satisfy itself that The Program meets the user’s 
requirements. The Program is supplied on an ‘as is’ basis and save as expressly provided in 
these conditions all warranties of any nature (and whether express or implied) are excluded. 

7. Liability 

Locomotive warrants that the diskette on which the program is stored is free from material 
defect and through normal use will remain so for a period of 90 days after purchase. In the 
event of any breach of this warranty (or statutory warranty or conditions incapable of 
exclusion by these conditions) the responsibilities of Locomotive shall be limited to 
replacing the enclosed program or to returning the price paid for the same as they shall 
determine. 

As the sole exception to the foregoing Locomotive will accept liability for death or personal 
injury resulting from its negligence. In no circumstance shall Locomotive be liable for any 
indirect or consequential costs damages or losses (including loss of business profits, 
operating lime or otherwise) arising out of the use or inability to use the enclosed program 
and diskette whether or not the likelihood of damage was advised to Locomotive or its dealer. 

This notice does not affect your statutory rights. 
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